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2.5.4  libfail 

(./sinmet/telease/src/vehicle/libsrc/libfail  [libfail]) 

This  library  determines  the  damages  to  the  vehicle  due  to  failures.  Failures  are  divided  into 
categories  that  indicate  the  method  used  for  failure  generation.  The  three  categories  are 
combat  damage,  stochastic  failure,  and  deterministic  failure; 

1)  During  combat  a  vehicle  receives  combat  information  messages  finom  the  network.  This 
information  comes  in  two  different  forms.  First,  impact  message  tells  the  vehicle  that 
someone  has  been  hit  by  an  incoming  direct  fire  round  or  missile  G)oth  referred  to  as  a 
round).  If  the  round  struck  another  vehicle,  then  the  message  is  ignored  for  purposes  of 
combat  damage.  The  vehicle  struck  by  the  round  uses  the  i^ormation  in  the  message  to 
calculate  any  damages  that  may  result  Second,  an  indirect  fire  message  tells  the  vehicle 
that  an  indir^t  fire  round  has  exploded.  The  impact  point  is  checked  to  determine  if  the 
impact  was  close  enough  to  damage  the  vehicle.  The  combat  damage  tables  are  read  in 
through  one  file  which  contains  references  to  other  data  files. 

2)  Deterministic  failures  are  those  failures  which  result  from  some  improper  action  by  the 
crew  that  generally  could  have  been  prevented.  These  include  both  failures  due  to  resource 
depletion  and  failures  due  to  crew  error.  Examples  of  these  errors  include  mismanaging 
fuel  and  ammunition,  ignoring  warning  lights,  and  throwing  a  track  while  driving  the 
vehicle  across  a  hill  with  too  great  a  slope.  The  deterministic  failure  table  is  read  in  through 
a  single  data  file. 

3)  A  stochastic  failure  occurs  when  a  vehicle  fails  on  its  own  and  not  because  of  a  crew 
error  or  due  to  combat  damage.  The  frequency  of  failure  is  determined  by  a  Mean  Number 
of  Operations  Between  Failures  (MNOBF).  Stochastic  failures  can  degrade  functions  or 
can  serve  as  a  warning  for  potential  deterministic  failures.  Stochastic  failures  are 
determined  with  the  use  of  a  data  file  (nal_sdamage.d). 
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2.5.4. 1  c_clBii._dain.c 

(ysiniietftfc^Tease/src/vehide/Ubsrc/libfaiVc_chk_(^ 

This  file  containsdiK:  code  to  generate  combat  damage.  An  index  is  generated  from  hit 
information  and  istttsed  to  test  for  combat  kill  or  da^ge. 

Includes: 

"stdioJif 

"math.h' 

"sim_type»s.h" 

"sim_dfiBJii" 

"sim_nncrros.h" 

"pro.dattL&i” 

"status.h"’ 

"failh" 

"faiLkxii’" 

"cfailJoKlin" 

"libnetwaB£k.h" 

2.5.4. 1.1  cf»li_check_damages 

This  routine  is  usediiay  failures  to  check  the  combat  damage  list 

damage  list  —  a  pointer  to  a  linked  list  of  possible  damages  to  the  vehicle 

agentjd,  event Ji,  mause  -  passed  to  the  network  if  sending  a  StatusChangePDU. 

If  the  vehicle  is  deifirroyed,  the  PDU  will  be  sent  from  the  routine 
fail_vehicleJs^ilts«troyed(),  rather  than  from  cfail  check_damages().  Note  that 
rtnjndex  of”l  lidk.catBS  catastrophic  kill.  For  debugging  purposes  only,  the  vehicle  will 
not  die  when  CFAUL_pEBUG  has  been  turned  on  (except  in  special  circumstances  such  as 
the  blast  door  is  ofexa). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

damaae  list 

DOinter  to  register  FAIL  TEST 

Section  2.5.4.15 

agentjd 

pointer  to  Vehk:ielD 

/simnet/common/include/prot 

ocol/basic.h 

event_id 

EventIO 

/simnet/common/include/prot 

ocol/basic.h 

cause 

DamageCause 

/simnet/common/include/prot 
ocol/p  data.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

damage_prob 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

percent 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

subsys 

pointer  to  VehicleSubsystems 

/simnet/common/include/glob 

al/status.h 
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Errors 

Error 

Reason  for  Error 

stderr 

-  Checking  damages 

-  possible  damage  =  #.  prob  =  #,  range  =  % 

Calls 

Function 

Where  Described 

rand 

Section  2.5.4.18 

fail  vehicle  is  destroyed 

Section  2.5.4.9.2 

fail  aet  delta  subsystems 

Section  2.5.4.14.8 

network  send  status  change 

Section  2.1.1.3.1.62.1 

Table  2.5-97:  cfail_check_damages  Information. 
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2L5.4.2  c_debug.c 

(ysimnetAelease/sic/vehicleiAibsrc/libfail/c_debug.c) 


fisdudes: 

"stdio.h” 

"math.h" 

''sim_types.h" 

"sim_<tfns.h" 

"sim_macros.h" 

ESedarations: 

CFAIL_DEBUG 

2.5.4. 2.1  cfail_debug_OD 

TShis  routine  is  used  for  debugging  purposes. 
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2. 5. 4. 3  c_dir  fire.c 

(ysmmetAelease/sn^ehicle4ibsic/libfail/c_dir_fire.c) 

Includes; 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"libmap.h" 

"mass_st(ic.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"fail.h" 

"cfail_loc.h" 

"libfaiLh" 

''libnetwork.h" 

"pro_sim.h" 

"pro_data.h" 

Defines; 

PI_DIV_6 

PI_DIV_3 

PI_DIV_2 

FIVE_PI_DIV_6 

TW0_PI_DIV_3 

RATIO_LENGTH_TO_WIDTH 

Variable  and  Procedure  Declarations; 
c_dir_fiie_debug 

cfail_compute_impact_incidence_angIe() 

norinali2e_x()” 

normalizej^O 
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2. 5. 4.3.1  cf«il_(IEr_fire_damages 

This  routine  is  called  wfaenevo’  it  is  necessary  to  compute  direct  fire  damages.  The 
parameter  hitjnessage  comtains  information  about  the  hit  (shell  type  and  hit  location).  This 
routine  calls  the  necessar^ji’  routines  to  check  for  both  catastrophic  kill  and  normal  combat 
damages.  Note  tb;at  this  zcoutine  will  not  be  called  under  certain  circumstances,  for 
example,  if  the  is  hit  Iby  a  large  calibre  round  when  the  blast  door  is  open, 
~ml_failure.c*'  wiill  skip  tflus  routine  and  make  a  call  directly  to  fail_cat_kili(). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

hit_msg 

pointer  to  register 

ImpactVariant 

/simnet/common/include/prot 
ocol/D  sim.h 

ammo  tvpe 

reaister  int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

iMt  loc 

reoister  int 

Standard 

this_ammo 

pointer  to  register 

GEN  AMMO  DAMAGES 

Section  2.5. 4.7 

damaae  file  index 

int 

Standard 

Errors 

Error 

Reason  for  Error 

stderr 

-  CFAIL:  invalid  ammo  type 

-  no  damage  table  for  ammo  type  yet 
•  cam  do  dir  fire  damage  on  indirect 

ammo_type 

-  composite  hit  location 

-  invalid  dam  info  for  ammo  type 

Calls 

Function 

Where  Described 

map_Oet_damage._fileJnclex_from_ 
ammo  entry 

Section  2.6.11.2.12 

cfail  oet  comoositte  index 

Section  2  5.4.3.2 

cfail  check  damaotes 

Section  2.5.4.1.1 

Table  13-9S:  cfail_dir_fire_damages  Information. 
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2.5 


.4.3.2 


cfail_get_composite_index 


This  routine  uses  the  vehicle  impact  packet's  account  of  where  the  incoming  round  hit  (the 
vehicle  location,  the  side  of  the  vehicle  that  was  hit,  and  the  incidence  angle)  to  create  a 
single  composite  hit  location  which  is  used  as  an  index  into  the  damage  table. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

hit_msg 

pointer  to  register 

ImpactVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

hit  location 

int 

Standard 

incidence  anale 

double 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

hiljocation 

int 

composite  hit  location;  index 
into  damage  table 

1  Calls  1 

Function 

Where  Described 

cfail  comoute  impact  incidence  anale 

Section  2.5.4.3.3 

cfail  compute  side  hit 

Section  2.5.4  3.4 

Table  2,5-99:  cfaiI_get_composite_index  Information. 

2. 5. 4. 3. 3  cfail_computeJmpact_incidence_angle 

This  routine  computes  the  incidence  angle  based  on  the  trajectory  and  vehicle  coordinates. 
Be  aware  that  this  code  defines  an  incidence  angle  as  an  angle  measured  horizontally  on  the 
horizon.  Certain  military  combat  damage  modelers  define  an  "incidence  angle"  as  an  angle 
measured  vertically  above  the  horizon  and  an  "aspect  angle"  as  an  angle  measured 
horizontally  on  the  horizon. 


1  Parameters  1 

■  Parameter  I 

Where  Typedef  Declared 

Hill  1  1  ll—— ■ 

float 

Standard 

1  Return  Values  i 

Return  Value 

trajectory[0],  trajectory[1] 

double 

the  incidence  angle 
(measured  in  radians) 

Table  2.5-100:  cfail_compute_impact_incidence_angle  Information. 
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2. 5. 4. 3. 4  cfail_compute_side_hit 

This  routine  computes  the  side  hit,  determining  in  which  quadrant  of  the  vehicle  the  impact 
occurred  based  on  impact  information  and  the  incidence  angle. 


2 

1 

3 

4 

I  Parameters  I 

Parameter 

Where  Typedef  Declared 

impactn 

fioat 

Standard 

incidence  anale 

double 

Standard 

I  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

temp  X 

double 

Standard 

temp  V 

double 

Standard 

hit  location 

int 

Standard 

I  Return  Values  I 

Return  Value 

Meaning 

hit  iocation 

int 

index  into  damage  table 

I  Calls  I 

Function 

Where  Described 

compute  incidence  from  front 

Section  2.5.4.3.8 

compute  incidence  from  right 

Section  2.5.4.3.10 

normalize  x 

Section  2.5.4.3.5 

normalize  v 

Section  2.5.4.3.6 

compute  incidence  from  ieft 

Section  2.5.4.3.9 

compute  incidence  from  back 

Section  2.5.4.3.7 

Table  2.5-101:  cfail_compute_side_hit  Information. 


2. 5. 4. 3. 5  normalize  x 


This  routine  normalizes  the  x  dimension  of  the  vehicle  size  to  between  0  and  1. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

X  POS 

float 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

x_pos 

float 

the  normalized  dimension 
(between  0  andl) 

Table  2.5-102:  normalize  x  Information. 
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2. 5. 4. 3. 6  norinaIize_y 

This  routine  normalizes  the  y  dimension  of  the  vehicle  size  to  between  0  and  1. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

y  pos 

float 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

yjpos/ 

RATIO  LENGTH  TO  WIDTH 

float 

the  normalized  x  dimension 
(between  0  and  1 ) 

Table  2.5>103:  norinalize_y  Information. 

2. 5. 4. 3. 7  compute_incidence_from__back 

This  routine  categorizes  the  incidence  angle  ftom  the  back  of  the  vehicle  into  either  0-30, 
30-60,  or  60-90  degrees. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

incidence  angle 

double 

Standard 

I  Return  Values  I 

Return  Value 

Meaning 

INCIDENCE_0_30 

int 

the  incidenr®  angle  is 
between  (  i  30  degrees 

INCIDENCE_30_60 

int 

the  incider  .  angle  is 
between  30  and  60  degrees 

INCIDENCE_60_90 

int 

the  incidence  angle  is 
between  60  and  90  degrees 

Table  2.5-104:  compute_incidence_from_back  Information. 
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2.5.4.3^iB  compute_incidence_froni_front 

This  routine  categorizes  the  incidence  angle  from  the  front  of  the  vehicle  into  either  0-30, 
30-60,  or  SO-90  degrees. 


Parameters 


Parameter 


incidence  atnale 


double 


Where  Tvoedef  Declared 


Standard 


Return  V»tue 


INCIDENCE_0_30 


INCIDENCE_30_60 


INCIDENCE  60  90 


IBT! 


Return  Values 


Meanin 


the  incidence  angle  is 
between  0  and  30  degrees 


the  incidence  angle  is 
between  30  and  60  degrees 


the  tncidence  angle  is 
between  60  and  90  degrees 


Table  2.5*105:  coinpute_incidence_from_front  Information. 

2 . 5 . 4 . 3 . 9  compute_incidence_f  rom  Jeft 

This  routine  categorizes  the  incidence  angle  from  the  left  side  of  the  vehicle  into  either  0-30, 
30-60,  or  60-90  degrees. 


Parameter 


incidence  angle 


lEiTIZ 


Parameters 


e 


double 


Where  Tvoedef  Declared 


Standard 


Return  Vaaue 


computejmcidencejrom 
backdncidence  angle) 


iE2!r: 


Return  Values 


Meanin 


the  category  of  the  incidence 
angle:  0-30,  30-60,  60-90 


Function 


compute  imcidence  from  back 


Calls 


Where  Described 


Section  2.5.4.37 


Table  2.5-106:  compute_incidence_from_left  Information. 


1032 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.5.4.3.10 


compute_incidence_from_right 


This  routine  categorizes  the  incidence  angle  from  the  right  side  of  the  vehicle  into  either 
0-30,  30-60,  or  ^-90  degrees. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

incidence  anaie 

double 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

computeJncidence_from_ 
back(incidence  anqie) 

int 

the  category  of  the  incidence 
angle:  0-30.  30-60,  60-90 

Calls 

Function 

Where  Described 

compute  incidence  from  back 

Section  2.5.4.3.7 

Table  2.5>107:  compute_incidence_from_right  Information. 
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2^.5. 4. 4  c_ind  fire.c 

(ysirnhet/r3[ease/src/vehicle/libsrc/libfail/c_ind_fire.c) 

IDhis  iSle  is  used  to  deteimine  damage  and  failures  resuldng  from  indirect  fire.  Indirect  fire 
esqdodes  adjacent  to  a  vehicle  rather  than  directly  on  a  vehicle. 

findudes: 

"stdio.h" 

••math.h" 

"sim_types.h" 

"simj^ns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"basic.h" 

"pro_sim.h’’ 

"pro_data.h" 

''mun_type.h" 

"failh" 

"cfail_loc.h" 

''libmatrix.h" 

''libnetwoik.h" 

"litanap.h" 

"UbfaiKh" 


\rariable  Declaration; 

c_ind_fire_debug 
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2 . 5 . 4 . 4 . 1  cfail_indirect_fire_damages 

This  routine  determines  the  damages  to  the  vehicle  from  indirect  fire.  The  index  to  the 
indirect  fire  damage  table  is  calculated  from  the  ammo  type,  the  distance  of  the  explosion 
firom  the  vehicle,  and  the  side  of  the  vehicle  that  the  explosion  occurred  on.  ammo  type  is 
the  index  to  array  of  ammunition  structures  in  libmap. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ammo  tvoe 

int 

Standard 

detonator 

ObjectType 

/simnet/common/include/prot 
ocol/p  sim.h 

shot 

pointer  to 

IndirectFireDetonation 

/simnet/common/include/prot 
ocol/p  sim.h 

range_sqrd 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

h_to_o 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

w_to_h 

T_MATRIX 

/simnet/common/include/glob 
al/sim  types.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

hit_pos 

VECTOR 

/simnet/common/include/giob 
al/sim  types.h 

hit  loc 

int 

Standard 

thisjsmmo 

pointer  to 

GEN  AMMO  DAMAGES 

Section  2.5.4.7 

damage  file  index 

int 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

stderr 

'  checking  ind  fire:  range_sqrd  =  #,  amnx)  =  # 

'  CFAIL:  invalid  ammo  type 
-  invalid  dam  info  for  amotype 

1  Calls  1 

Function 

Where  Described 

mapjget_damage_fileJndex_from_ammo_ 

entry 

Section  2.6.11.2.12 

vec  mat  mul 

Section  2.6.2.56.1 

vec  sub 

Section  2.6.2.64.1 

cfail  oet  indirect  index 

Section  2.5.4.4.2 

cfail  check_damages 

Section  2.5.4. 1.1 

Table  2.5>108:  cfail_indirect_f1re_damages  Information. 
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2. 5. 4. 4. 2  cfail_get_indirect_index 

This  routine  determines  the  index  to  the  indirect  fire  damage  table  and  returns  the  composite 
hit  location,  which  is  used  as  the  index  to  the  damage  table.  The  index  to  the  indirect  fire 
damage  table  is  calculated  from  the  ammo  type,  the  distance  of  the  explosion  from  the 
vehicle,  and  the  side  of  the  vehicle  that  the  explosion  occurred  on. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

ammo 

int 

Standard 

detonator 

ObjectType 

/simnet/common/include/prot 
ocol/p  sim.h 

range_sqrd 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

ranges 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

hitjx)s 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

hit  location 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

hitjocation 

int 

the  composite  hit  location 
used  as  the  index  to  the 
indirect  fire  damage  table 

Table  2.5*109:  cfan_geMndirecMndex  Information. 
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2.5.4.S  c_init.c 

(ysinihet^lease/srcA'ehicle/libsrc/libfail/c_iniLc) 

Includes: 

''st(iio.h" 

"inath.h" 

"sim_types.h" 

"sim_<Uhs.h" 

"sim_macros.h" 

"mass_stdc.h" 

’'dgi_stdg.h" 

"sim_cig_if.h" 

"fail.h" 

"cfaU_loc.h’* 

"Ubfail.h" 

"simstdio.h" 

Procedure  and  Variable  Declarations: 
cfail  cdamages_init() 
cfail_kilMnit() 
mallocO  “ 

exitO  -Simnet  Butterfly  Machine  only 
freeO 

iniMndirect  fire_table() 
init”dircct_frre  table() 
darriage_fileZrootf50] 


Defines: 

CX)MMENT_SIZE 
2. 5. 4. 5.1  cfaiMnit 

This  routine  initializes  the  combat  failures  module.  The  routine  takes  one  parameter, 
cd  Jilejrootjiivt  directory  path  used  to  search-^pr  the  combat  damage  file ,  for  example, 
"/simnet/vehicle/ml/data/ml".  The  combat  daimge  file  is  read  in  tlrough 
cfaU_read_daniage  fileO*  For  each  type  of  ammo,  the  damage_by_type  array  contains 
information  about  ea^  ammo  type  and  how  the  vehicle  can  be  dama^  by  that  ammo  type. 
This  routine  also  zeroes  out  the  damage.by-QT^  array,  in  order  to  ignore  unkown  ammo 
types. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

led  file  root 

pointer  to  char 

Standard 

1  Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.5-110:  cfail  init  Information. 
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Parameter 


dama 


ammo  mao  nndex 


damaoe  file 


IEI7? 


inter  to  char 


int 


unsioned  char 


Parameters 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Variable 


ammo  f 


damaoe  file  mame 


Internal  Variables 


e 


inter  to  reoister  FILE 


char 


IE27? 

\n 


Where  Tvoedef  Declared 


Standard 


Return  Value 


FALSE 


TRUE 


lElT! 


Return  Values 


Meanin 


rocedure  failed 


Error 


stderr 


Errors 


Reason  for  Error 


-  PANIC -- cam  open  file 


Function 


init  indirect  f^re  table 


init  direct  lire  table 


Calls 


Where  Described 


Section  2.5.4.5.3 


Section  2.5.4.5.4 
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2 . 5 . 4 . 5 . 3  inU_indirect_fire_tabIe 

This  routine  is  used  to  initialize  the  indirect  fire  damage  tables.  First,  it  allocates  memory 
for  the  table.  Then,  it  reads  the  squared  ranges,  checl^g  for  a  valid  range  of  data. 
Finally,  it  calls  cfail  cdamages_initO  to  read  in  the  list  of  possible  damages  for  each 
range  and  heading  ofindirect  fire.  The  distance  of  the  vehicle  firom  the  indict  fire 
explosion  is  categorized  into  one  of  four  ranges  based  on  the  type  of  ammo:  direct,  near 
miss,  far  miss,  or  miss.  No  damage  will  occur  outside  of  the  miss  range. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

ammo  fp 

pointer  to  FILE 

ammo  tvpe 

int 

Standard 

ammo  file 

pointer  to  char 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

range 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

1  Errors  1 

Error 

Reason  for  Error 

stderr 

-  FAIL:  insufficient  memory  for  combat  tables 

-  FAIL:  unexpected  eof  found  in  file 

-  FAIL:  invalid  range 

1  Calls  1 

Function 

Where  Described 

cfail  damages  init 

Section  2.5.4  5.5 

Table  2.5-112:  init_indirect_fire_table  Information. 
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2. 5. 4. 5. 4  init_direct_fire_table 
This  routine  initializes  t&s  direct  fire  table. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

ammo  fo 

pointer  to  FILE 

ammo  tvoe 

int 

Standard 

ammo  file 

pointer  to  char 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

stderr 

•  FAIL:  insufficient  memory  for  combat  tables 

1  Calls  1 

Function 

Where  Described 

cfait  damaaes  inrt 

Section  2.5.4.5.5 

Table  2.J5-113:  init_direct_fire_table  Information. 
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2. 5. 4. 5. 5  cfail_daniages_init 

This  routine  is  used  to  initialize  the  table  which  contains  normal  combat  damages.  This 
routine  reads  in  the  bulk  of  the  damages.  In  order  to  initialize  the  damage  table  the  routine 
expects  to  be  passed  the  index  the  the  damage  table,  the  index  into  the  dispatch  table,  and 
the  probability  of  a  particular  failure  happening. 

The  damage  table  is  set  up  under  the  following  conditions:  for  any  hit  (consisting  of  a  shell 
type,  hit  location,  shell  diiection,  and  angle  of  incidence)  there  may  be  several  possible 
failures.  Each  failure  has  an  associated  probability  of  occuirance  and  an  index  to  a  routine 
which  is  called  if  the  failure  occurs.  For  example,  there  may  be  a  30%  chance  that  failure  4 
occurs  for  a  certain  hit.  If  the  30%  chance  is  true,  then  the  routine  indexed  by  number  4  is 
called.  In  this  case,  the  radio  antenna  would  be  broken,  and  the  tank's  communciations 
would  be  affected  accordingly. 

To  keep  track  of  this  information,  an  array  of  linked  lists  is  created.  The  index  to  the  array 
is  formed  by  logically  OR-ing  together  the  various  components  of  the  hit  (shell  type,  hit 
location,  angle  of  incidence,  etc.).  The  array  contains  a  pointer  to  a  list  of  possible  failures 
for  that  hit  Each  failure  contains  the  routine  index  for  Ae  hit,  the  chance  of  occurrance, 
and  a  pointer  to  the  next  possible  failure. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

ammo  fo 

pointer  to  FILE 

damaqe  arravn 

pointer  to  FAIL  TEST 

Section  2.5.4.1.5 

table  size 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

fail  Dtr 

pointer  to  reaister  FAIL  TEST 

Section  2.5.4.1.5 

index 

int 

Standard 

ret 

int 

Standard 

char 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

stderr 

-  FAIL;  insufficient  memory  for  combat  tables 

Table  2.5>114:  cfail_cdamages_init  Information. 
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2. 5. 4. 6  cfail  loc.c 

(ysimnet^lease/srcArehicle/libsrc/libfail/cfail_loc.c) 


Includes: 

“stdio.h" 

”math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros,h" 

"mass.sidc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"fail.h" 

"cfaU.h" 


Declaration: 

damage_by_type[EFF_KIND_MASK] 

2. 5. 4. 7  cfail  loc.h 

(ysimnet^lease/sic/vehicle/libsrc/libfail/cfail_loc.h) 


Defines: 

INCIDENCE_0_30 

INCIDENCE_30_60 

INCIDENCE_60_90 

HIT  FROM.LEFT 
HIT_FROM_RIGHT 
HlT_FROM_BACK 
HIT_FROM_FRONT 

HIT  ON.FRONT 
HIT_ON_RIGHT 
HTT.ON.BACK 
HIT_ON_LEFT 

HIT  ON_HULL 
HIT_ON_TURRET 

DIR_TABLE_SIZE 

IND_SIDE_LEFT 

IND_SIDE_REAR 

IND_SIDE_RIGHT 

IND_SIDE_FRONT 

IND_RANGE_DIRECT 
IND_RANGE  NEAR 
IND_RANGE_FAR 
IND_RANGE_MISS 

IND_FUZE_PD 

IND_FUZE_VT 
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IND_TABLE_SIZE 

NUM_RANGES 

RANGE_DIRECT 

RANGE.NEAR 

RANGE.FAR 

RANGE_MISS 

NO.TABLE 

DIRECT_FIRE 

INDIRECT_FIRE 


Variable  and  Procedure  Declarations: 
cfail_cdamages_init() 
cfail~check_dainages() 
cfail_get_coriiposite_index() 
daniage_by_type[] 

CFAIL_DEBUG 

Typedefs: 

DIR_AMMO_DAMAGES 

IND_AMMO_DAMAGES 

GEN_AMMO_DAMAGES 

2. 5. 4. 8  f__brcak_sys.c 

(ysiinhei/relea«/src/vehicl^bsrc/libfail^_break_sys.c) 


Includes: 

"stdio.h" 

"inath.h" 

"pn)_data.h" 

"sim_types.h" 

"sini_<tfns.h" 

"sini_inacros.h" 

"libevenLh" 

"UbfaiLh" 

"libnetwork.h" 

"librepair.h" 

"fail.h" 

"fail_loc.h" 
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2. 5. 4. 8.1  fail_breflk_systein 

This  routine  is  an  external  iproceduie  which  is  called  from  outside  libfail  when  it  is 
determined  that  a  sysaem  should  break.  It  generates  an  event  id  for  the  breakage,  breaks 
the  system,  and  noti&es  the  network  to  send  a  StatusChangePDU. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

agentjd 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

cause 

OamageCause 

/simnet/common/include/prot 
ocol/D  data.h 

system  num 

int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

event_id 

EventiD 

/simnet/common/include/prot 

ocol/basic.h 

subsys 

pointer  to  VehicleSubsy stems 

/simnet/common/include/prot 

ocol/status.h 

Calls 

Function 

Vyhere  Described 

fait  system  is  broken 

Section  2.5.4  8. 2 

fail  qet  delta  subsystems 

Section  2.5.4.14.7 

event  qet  eventid 

Section  2.6.9. 1.2 

network  send  status  charrqte 

Section  2.1.1.3.1.62.1 

Table  2.J-115:  fail_break_system  Information. 

2. 5. 4. 8. 2  faiI_5y»teim_is_broken 

This  routine  is  called  when  either  the  combat  failures  or  stochastic  failures  parts  of  libfail 
determine  that  a  system  bneaks.  The  parameter,  system  nwnber,  signifies  which  system  is 
to  break. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

system  num 

int 

Standard 

Calls 

Function 

Where  Described 

fail  set  subsys  bit 

Section  2.5.4.14.8 

repair  start  self  repair 

Section  2.5.4.19.8 

Table  2..'?'116  fail  system  is  broken  Information. 
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2.5.4.9  f_cat_kill.c 

(7simnet/release/srcArehiclc/libsrc/libfaiW_cat_kill.c) 


Includes: 


"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_<tfns.h" 

"sim_macros.h" 

"pro_data.h" 

"UbevenLh" 

"libfaiLh" 

"libsoundh" 

"libnetwork.h" 

"faiLh" 

"fail  loc.h" 


2.5.4.9.1  fail_cat_kill 

This  routine  is  called  to  break  every  subsystem  when  a  catastrophic  kill  determination  has 
been  made  externally  to  the  libfail  code. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

agent_id 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

cause 

OamageCause 

/simnet/common/include/prot 
ocol/D  data.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

event_id 

EventID 

/simnet/common/include/prot 

ocol/basic.h 

1  Calls  1 

Function 

Where  Described 

event  aet  eventid 

Section  2.6.9.1.2 

fail  vehicle  is  destroyed 

Section  2.5.4.9.2 

Table  2.5>117:  fail  cat  kill  Information. 
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2.S.M.9,2  fail_vehicle_is_destroyed 

’niisnoutioe  is  called  when  a  catastrophic  kill  determination  has  been  made  from  a  libfail 
roudme. 


1  Parameters  I 

Parareneter 

Type 

Where  Typedef  Declared 

agent_id 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

6vent__id 

EventID 

/simnet/common/include/prot 

ocol/basic.h 

cause 

DamageCause 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

subsy;s 

pointer  to  VehicleSubsystems 

/simnet/common/include/prot 
ocol/p  data.h 

1  Calls  1 

Funcblon 

Where  Described 

sound  we  just  died 

Section  2. 1.3. 2.8 

contrails  electsys  dead 

Sections  2.2.2,  2.3.2,  and  2.4.2 

controHs  break  controls 

Sections  2.2.2,  2.3.2,  and  2.4.2 

vision  'i>reak  all  blocks 

Sections  2.2.6.4.3.  2.3.6.3.2.  and  2.4.5.1 

networdc  set  death  status 

Section  2.1.1.3.1.11.1 

networrk  set  smokino  status 

Section  2.1.1.3.1.11.2 

netwosrk  set  burnina  status 

Section  2.1.1.3.1.11.3 

fail  scat  svbsys  bit 

Section  2.5.4.14.8 

fail  arst  delta  subsystems 

Section  2.5.4.14.7 

networfik  send  status  change 

Section  2.1.1.3.1.62 

Table  2.5-118:  fail_vehicle_is_destroyed  Information. 


2.5.41.10  f_dth_stat.c 

(ysimnet/release/src/vehicle/libsrc/libfail/f_dth_stat.c) 

IncliKdes: 

"stdio.h" 

"math.h" 

"sim_iypes.h" 

"sim_dfns.h" 

"sim_macros.h" 

"failjoc.h" 
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2.5.4.10.1  fail_death_status 

This  routine  tells  whether  you  are  dead  or  not. 


1  Return  Values  1 

Return  Value 

Meanina 

we  are  dead 

int 

we  are  dead 

Table  2.5-119:  fail_death_status  Information. 
2.5.4.11  Mnit.c 

(ysiinnet/rclease/src/vehicle/libsrc/libfai]/f_iniLc) 


Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"address.h" 

"basic.h" 

"fail_loc.h" 

"UbfaiLh" 

2.5.4.11.1  failjablejnit 

This  routine  is  called  to  initialize  the  failure  dispatch  table.  When  a  failure  occurs,  it  is 
specified  by  a  failure  number  as  defined  in  /simnet/include/protocol/failure.h.  The  failure 
^spatch  table  maps  the  failure  indices  to  the  set  of  failure  routines.  This  routine,  however, 
initializes  the  dispatch  table  to  all  zeroes.  Individual  failures  must  be  initialized  through 
fail_init_failure(),  below. 


Internal 

Variables 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

fail  subsvs  init 

Section  2.5.4.14.1 

Table  2.5-120:  fail  table  init  Information. 
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2.5.41.11.2  fall  init  failure 


TMs  imutine  is  called  to  initialize  an  entry  in  the  failure  dispatch  table.  The  vehicle  specific 
st^twaoe  calls  this  routine  for  each  failure  modeled.  Each  system  must  be  initialized 
tfanrou^  diis  routine  in  order  to  be  allowed  to  fail.  The  routine  returns  FALSE  if  any 
pairamtster  information  (fail  ntm,  self  repair,  or  summaryKil^  is  out  of  bounds,  and 
letturms  TRUE  otherwise.  Note  that  the  failure  and  repair  routine  pointers  can  be  NULL  if 
desiretd,  though  this  does  not  make  the  simulated  failure  very  realistic.  The  fail  num 
paramsi^  is  the  failure  number  as  defined  in  the  protocol  file  "failure.h".  The fail_rtn  and 
r^air^rtn  are  pointers  to  the  fail  and  repair  routines.  These  routines  actually  cause  the 
fiailure  or  repair  to  occur,  selfjrepair  is  the  self  repair  time  (in  minutes).  Certain  systems 
ane  stronmarized  together,  for  example,  the  turret  and  gun  are  summari^  as  fire  power 
^^teixKS.  The  summaryKill  parameter  tells  which  summary  failures  are  mapped  to  the 
jxartici^ar  failure. 


1  Parameters  I 

Paraimeter 

Where  Typedef  Declared 

fail  nuim 

int 

Standard 

failLrtrt 

PFV 

/simnet/common/include/glob 
al/sim  types. h 

fBpair_irtn 

PFV 

/simnet/common/include/glob 
al/sim  tvpes.h 

seltf  recsair 

int 

Standard 

surmmai^^Kill 

int 

Standard 

1  Return  Values  1 

Re^turm  Value 

Type 

Meaning 

FALSE 

int 

either  selfjrepair  ox  fail_num 
parameter  is  invalid 

TRiUE 

int 

procedure  was  successful 

1  Calls  1 

Funct^ton 

Where  Described 

lain  failure  exists 

Section  2.5.4.14.3 

Table  2.5*121:  fail  init  failure  Information. 
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2.5.4.11.3  faiMnit 

This  routine  is  called  from  libmain  as  the  final  initialization.  It  is  used  to  reactivate  a  towed 
vehicle  with  its  original  failures  intact  The  initial  failures  are  determined  by  the  Vehicle 
Subsystems  in  the  Activate  packet  and  are  broken  by  this  routine. 


1  Internal  Variables  1 

[Variable 

Where  Typedef  Declared 

Iflaq  num 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

fail  reincarnation 

Section  2.5.4.12.1 

controls  restore  controls 

Sections  2.2.2,  2.3.2,  and  2.4.2 

fail  is  component  broken 

Section  2.5.4.14.6 

fail  system  is  broken 

Section  2.5.4.8.2 

Table  2.5-122:  fail  init  Information. 
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2.5.4.12  f_reincarn.c 

(7siinhet/release/src/vehicle/Iibsic/libfaiW_reincam.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_<fehs,h" 

"sim_macros.h" 

"fail_loc.h" 

2.5.4.12.1  fail_reincarnation 

This  routine  is  a  debugging  tool  used  to  revive  a  dead  vehicle  without  reconstituting  it. 


Function 

Where  Described 

network  set  death  status 

Section  2.1.1.3.1.11.1 

network  set  smokino  status 

Section  2.1.1.3.1.11.2 

network  set  burnina  status 

Section  2.1.1.3.1.11.3 

Table  2.5>123:  fail  reincarnation  Information. 
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2.5.4.13  f_simul.c 

(ysinmetAelease/sic/vehicle/libsrc/libfail^.simul.c) 


Includes: 

"stdio.h" 

"inath.h" 

"sim_types.h'' 

"sim_ctfns.h'’ 

”sim_inacros.h” 

"libeventh" 

"libnetworic.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

'’sim_cig_if.h" 

"Ubrva.h" 

"pro_data.h" 

"faU_loc.h" 

"libfaiLh" 

"timers.h" 

2.5.4.13.1  fail_siinul 

This  routine  checks  to  see  if  the  vehicle  is  done  burning  or  smoking  and  checks  to  see  if  the 
self-repair  timers  have  timed  out. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

burn  time 

int 

Standard 

smoke  time 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

network  set  smokina  status 

Section  2.1.1.3.1.11.2 

metwork  set  burnina  status 

Section  2.1.1.3.1.11.3 

timers  set  null  timer 

Section  2.6.3.14.1 

timers  aet  timeout  edae 

Section  2.6.3.22.1 

timers  free  timer 

Section  2.6.3.5.1 

fail  clear  subsvs  bit 

Section  2.5.4.14.9 

network  send  status  change 

Section  2.1.1.3.1.62.1 

Table  2.5-124:  fail_siniul  Information. 
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2.5.4.14  f_subsys.c 

(ysimhetAelease/src/vehicle/libsrc/libfai]^_subsys.c) 


Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"pro_data.h" 

"status.h" 

"Ubeventh" 

"fail.h" 

••faUJoc.h" 

This  file  contains  routines  to  keep  track  of  the  protocol  defined  data  structure, 
VehicleSubsystem,  which  tells  which  kill  levels  have  been  achieved  and  which  conr^nents 
have  been  dunaged.  In  most  cases,  the  VehicleSubsystems  are  treated  as  arrays  of  ints  in 
order  to  facilitate  setting  and  clearing  of  important  bits.  In  the  VehicleSubsystems 
structure,  space  is  allocated  as  follows: 

<subsysl_exists> 

<subsysl_status> 

<subsys2_exists> 

<subsys2_status> 

Since  failures  are  numbered  sequentially  without  gaps,  the  gaps  need  to  be  included  when 
calculating  which  bit  to  set  (assuming  that  each  subsystem  is  exactly  32  bits  and  that  an  int 
is  32  bits).  Since  the  network  protocol  definition  of  a  VehicleSubsystem  is  set  up  in  a  way 
that  is  (fifficult  for  libfail  to  dir^tly  set  and  clear  bits  while  using  the  most  convenient 
definitions  for  the  simulation,  the  local  type  LocalSubsys  is  declared  to  be  the  same  space 
as  VehicleSubsystems,  but  is  much  simpler  for  libfail  to  access.  The  first  element  of  each 
component  array  indicates  if  the  component  exists,  and  the  second  indicates  component 
stams.  Both  types  use  the  subsysten£xists  and  subsystems tatus  as  defined  in  "status.h". 

This  file  defines  numComponents. 

This  file  contains  a  typedef  of  LocalSubsys. 


This  file  declares: 

per_subsys 

delta_subsys 

(telta.changed 

temp_subsys 


—  the  permanent  list  of  which  subsystems  are  broken  and 
which  are  not.  If  a  component  is  broken  it  cannot  be 
rebroken. 

"  a  local  list  used  to  keep  a  temporary  running  total  of  the 
broken  subsystems.  Used  by  failures  and  repairs  to  generate 
the  "subsystems"  field  of  the  StatusChangePDU. 

—  a  True/False  variable,  tells  if  delta_subsys  has  changed  since 
last  call  to  fail_gct_delta_subsystems(). 

“  a  local  list  used  to  keep  a  copy  of  delta_subsys  for  use  by  the 
outside  world. 
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kill_levels[MaxNuniFailures] 

--  need  to  set  to  noKill  (one  per  failure) 

2.5.4.14.1  fail_subsys_init 

This  routine  initializes  the  fail  systems,  checking  that  an  unsigned  long  integer  is  32  bits. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.5>i25:  fail_subsys_init  Information. 

2.5.4.14.2  fail_set_subsys 

This  routine  sets  the  initial  permanent  subsystems  by  copying  the  failures  array  into  the 
local  space.  The  failures  which  correspond  to  the  broken  components  are  then  initialized 
from  fail_init(),  in  "f_init.c". 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

new_subsys 

pointer  to  VehicieSubsystems 

/simnet/common/include/prot 
ocol/p  data.h 

Table  2.5-126:  fail_set_subsys  Information. 

2.5.4.14.3  fail_failure_exists 

This  routine  is  called  from  fail  init_failure()  to  indicate  that  a  particular  failure  should  be 
enabled.  The  subsystemExists  Ibit  cofresponding  to  the  failure  is  set  to  indicate  that  the 
subsystem  exists  and  is  capable  of  that  failure.  The  summary  Jail  parameter  indicates  to 
which  summary  failures  (if  any)  this  particular  failure  is  mapped.  The  summary  kill  levels 
associated  with  the  failure  are  drawn  from  "status.h"  and  defined  in  "libfail.h". 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fail  num 

int 

Standard 

summary  kill 

int 

Standard 

internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

subsvs  num 

int 

Standard 

subsys  bit 

int 

Standard 

Table  2.5-127:  fail_failure_exists  Information. 
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2.5.4.14.4  fail_clear_subsys 

This  routine  clears  out  a  subsystems  summary  and  component  status  list.  It  is  assumed  that 
the  subsystemExists  array  will  be  set  only  once. 


1  Parameters  1 

1  Parameter 

Where  Tvpedef  Declared 

1  subsvs 

pointer  to  LocalSubsys 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.5*128:  fail_clear_subsys  Information. 

2.5.4.14.5  fail_get_perm_subsys 

This  routine  is  called  by  the  network  to  get  a  complete  list  of  what  is  broken  and  the 
speciEc  failures  due  to  combat  action.  The  routine  gives  a  pointer  to  the  failure  flags  so  the 
network  can  send  a  list  of  failures  in  the  VehicleStatusPDU. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

&perm_subsys 

pointer  to  VehicleSubsystems 

/simnet/common/include/prot 
ocol/p  data.h 

Table  2.5-129:  fail_get_perm_subsys  Information. 
2.5.4.14.6  fail_is_componen t_broken 

This  routine  is  called  to  determine  if  a  particular  failjiwn  is  broken.  The  routine  returns 
FALSE  if  the  failure  does  not  exist  or  is  not  broken,  and  returns  TRUE  if  the  failure  both 
exists  and  is  broken. 


1  Parameters  1 

■  Parameter 

Where  Typedef  Declared 

Mail  num 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

subsys  num 

int 

Standard 

subsys  bit 

usigned  long  int 

Standard 

1  Return  Values  1 

Return  Value 

FALSE 

int 

either  failure  does  not  exist  or 
is  not  broken 

TRUE 

int 

failure  exists  and  is  broken 

Table  2.5-130:  fail  is  component  broken  Information. 
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2.5.4.14.7  fail_get_delta_subsystems 

This  routine  is  called  when  a  statusChangePDU  is  sent.  It  returns  a  pointer  to  the 
VehicleSubsystems  that  have  changed  since  the  last  call  to  this  routine.  If  nothing  has 
changed  since  then,  it  returns  NULL. 


1  Return  Values  1 

Return  Value 

Meanina 

NULL 

pointer  to  VehicleSubsystems 

no  changes  to 
VehicleSubsystems 

&temp_subsys 

pointer  to  VehicleSubsystems 

the  changes  to 
VehicleSubsystems  since  the 
last  call 

1  Calls  1 

Function 

Where  Described 

fail  clear  subsvs 

Section  2.5.4.14.4 

Table  2.5>131:  fail_get_delta_subsystems  Information. 
2.5.4.14.8  fail_set_subsys_bit 

This  routine  is  called  within  libfail  to  set  the  failure  flags  associated  with  a  particular 
subsystem.  The  failure  flag  is  specified  by  the  parameter  fail  num.  The  routine  returns 
FALSE  if fail  jam  is  invalid  or  if  the  system  was  already  broken,  and  returns  TRUE 
otherwise,  particular  subsystem  specified,  sets  particular  flags  bit.  checks  for 
summaiyKill  bit. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

fail  num 

int 

Standard 

I  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

subsvs  num 

int 

Standard 

subsvs  bit 

unsioned  lono  int 

Standard 

I  Return  Values  I 

Return  Value 

Meaning 

FALSE 

int 

invalid  te//_num  or  system  is 
already  broken 

TRUE 

int 

procedure  was  sucessful 

Table  2.5-132:  fail_set_subsys_bit  Information. 
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2.5.4.14.9  faiM_clear_subsys_bit 

This  routine  is  caiBed  by  repairs  to  reset  the  failure  flag  associated  with  a  particular 
subsystem  repainm  order  to  indicate  that  the  subsystem  has  been  repaired.  The  particular 
failure  to  clear  is  s^pecifed  by  the  parameter  failjium.  Returns  FAl^E  if  fail  rum  is 
invalid  or  if  the  ccsmponent  was  not  broken;  returns  TRUE  otherwise. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

fail  num 

int 

Standard 

1  internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

subsys  num 

int 

Standard 

subsys  bit 

unsianed  Iona  int 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

FALSE 

int 

fail_num  is  invalid  or  the 
component  was  not  broken 

TRUE 

int 

procedure  was  successful 

Talble  2.5-133;  fail_clear_subsys_bit  Information. 
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2.5.4.15  fail.h 

(ysimnet/telease/srcA'ehicle/Iibsrc/libfail/fail.h) 


Typedef: 

FAIL_TEST  --  the  structure's  component  consists  of; 

rtn  jndex  -  the  routine  used  to  implement  the  failure 
prob  -  the  probability  of  failure 
next  -  the  next  failure  to  occur 

2.5.4.16  fail  loc.c 

(ysimne^lease/src/vehicle/libsrc/libfail/fail_loc.c) 


Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"fail_loc.h" 

"UbfaiLh" 

Declarations: 

we_are_dead  --  tells  if  we  are  dead 
repair_timers[NUM_SELF_REPAIR_TIMERS] 

—  instanciation  of  a  self  repair  timer  stmcture. 
dispatch_table[MaxNumFailures] 

SELF_REPAIR_TIMER 

-  an  externally  declared  timer  which  is  started  when  the  self 
repair  starts  to  count  down.  This  timer  tells  how  long  the 
repair  takes  and  which  system  gets  repaired. 

FAIL_INFO  "  Every  system  able  to  fail  has  one  of  these  structures,  where: 

fail  rtn  tells  which  routine  implements  the  failure 
repair _rtn  tells  which  routine  to  fix  the  failure, 
self  repair  timer  gives  a  countdown  time  if  applicable 

2.5.4.17  fail  loc.h 

(ysimnet7release/src/vehicle/libsrc/libfail/fail_loc.h) 

Include  "libfail.h" 

Defines* 

’  NUM_SELF_REPAIR_TIMERS 
MaxNumFailures 

BURNING_TIME  -  bum  for  15  minutes  after  being  killed 
SMOKING_TIME  --  smoke  for  30  minutes  after  being  killed 

Typedefs: 

SELF_REPAIR_TIMER 

FAIL_INFO 

Declarations: 

repair_timers[] 
we_are  dead 
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disp»dh_table[] 
fail  flBiilure_exists() 
fai0iB_component  broken() 
fail~snet_su  bsys_bit  ( ) 
failHcdtear  subsys_bit() 
fail~ubit  fiagsO  ~ 

failjEatJkilU) 

fail3fcr^k_systein() 

fail_b«reak_flag() 

fail^nepaii^flagO 

fail~aftrart_self_repair() 


2J5.4.18  rand.c 

(ysimmet^ease/sic/vehicle/libsrc/libfail/rancLc) 


Tlnu  file  contains  two  different  standard  algorithm  choices  for  generating  randrnn  numbers. 
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2.5.4.19  repair.c 

(ysimnet/release/src/vehicle/libsrc/libfailAepair.c) 


This  file  contains  the  repairs  functionality.  Repairs  can  be  classiHed  in  the  following  two 
ways: 

1)  The  MCC  Maintenance  console  may  arrange  with  the  crew  to  send  a  repair  truck  to 
the  vehicle  to  perfoim  the  repair. 

2)  Self-repairs  in  which  the  crew  can  repair  certain  failures  themselves  (usually 
deterministic  failures).  The  repairs  are  timed  through  the  self-repair  timer,  the  failure 
fixes  itself  after  the  set  amount  of  time. 


Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"librva.h" 

"libnetwork.h" 

"llibrepair.h" 

"libevenLh" 

"fail_loc.h" 

"timers.h" 


Declarations: 

repair_mapping 


-  The  set  of  mapping  between  failures  and  repairs.  One  repair 
may  fix  more  than  one  failure.  The  mapping  is  set  up  in  the 
vehicle  specific  code. 


num_replace_repair 


2.5.4.19.1  lrepair_init 

This  routine  is  called  by  the  vehicle  specific  code  to  insert  the  set  of  mapping. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

veh  dependent  mappina 

pointer  to  short 

Standard 

num  maps 

int 

Standard 

Table  2.5>134:  Irepairjnit  Information. 
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2.5.4«im2  aepair  uninit 

This  nxtt^jsindled  to  uninitialize  a  vehicle  in  order  to  clear  out  the  self-repair  timers. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

1  Calls  1 

Functlen 

Where  Described 

timers  s(9t  aulC  diner 

Section  2.6.3.14.1 

tiemrs  fnaetirrar 

Section  2.6.3.5.1 

Table  2.5<135:  repair_uninit  Information. 


2.5. 4.  ti  Kepair_fix_system 


This  rotutiBT&silled  from  external  to  libfail  in  order  to  repair  a  system. 


1  Parameters  1 

Paramefts 

Where  Typedef  Declared 

cause 

DamageCause 

/simnet/common/include/prot 
ocol/p  data.h 

reoair  code 

int 

Standard 

1  Return  Values  1 

Return  'Wrttae 

Meaning 

repairjsysbitsJJixed 
(&vehiciefl  Oh?  ^rtrant, 
event^«?t^aitl(NO_  SKIP) , 
cause,  repax^ade) 

int 

whether  valid  repair  code: 
if  TRUE  then  repair  code  is 
valid 

if  FALSE  then  repair  code  is 
invalid 

1  Calls  1 

FunctlOiH 

Where  Described 

repair  sv^sbnr  » fixed 

Section  2.5.4.19.4 

event  aet  e^ivaUd 

Section  2. 6.9. 1.2 

Table  2.5>136:  repair_fix_system  Information. 
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2.5.4.19.4 


repair_systeni_is_fixed 


This  routine  is  called  internally  from  libfail  in  order  to  repair  a  system. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

agent Jd 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

event_id 

EventID 

/simnet/common/include/prot 

ocol/basic.h 

cause 

OamageCause 

/simnet/common/include/prot 
ocol/p  data.h 

repair  code 

int 

Standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

fail  svs 

int 

Standard 

subsys 

pointer  to  VehicieSubsystems 

/simnet/common/include/prot 
ocol/p  data.h 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

repair  code  \s  invalid 

TRUE 

int 

repair  code  is  valid 

1  Calls  1 

Function 

Where  Described 

fail  clear  subsys  bit 

Section  2.5.4.14.9 

fail  oet  delta  subsystems 

Section  2.5.4.14.7 

network  send  status  change 

Section  2.1.1.3.1.62.1 

Table  2.5-137;  repair_system_is_fixed  Information. 


2.5.4.19.5  repair_fix_failure 

This  routine  allows  the  repair  system  to  be  bypassed  in  order  to  fix  a  specific  failure.  The 
routine  is  used  when  the  failures  to  repairs  mapping  is  not  needed. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

failure  code 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

fail_clear_subsys_bit 

Section  2.5.4.14.9 

Table  2.5-138:  repair_fix_failure  Information. 
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2.5.4.19.6  repair_complete_system 

This  routine  fixes  the  complete  system  when  the  self-repair  timers  reach  zero. 


Parameter 


svs  num 


Parameters 


where  Typedef  Declared 


Standard 


EZmnUElHHiHHBI  EIT! 


Internal  Variables 


e 


Where  Typedef  Declared 


int  I  Standard 


subsys  pointer  to  VehicleSubsystems  /simnet/common/include/prot 

ocol/D  data.h 


Calls 

Function 

Where  Described 

timers  free  timer 

Section  2.6.3.5.1 

timers  set  null  timer 

Section  2.6.3.14.1 

fail  clear  subsys  bit 

Section  2.5.4.14.9 

fail  aet  delta  subsystems 

Section  2.5.4.14.7 

network  send  status  change 

Section  2.1.1.3.1.62.1 

event  get  eventid 

Section  2.6.9. 1.2 

Table  2.5-139:  repair_complete_system  Information. 
2.5.4.19.7  repair_all_systems 

This  routine  is  called  when  the  vehicle  is  reincarnated  in  order  to  bypass  the  repair  facility 
and  call  all  repair  routines.  The  routine  may  only  be  called  from  the  keyboard. 


Variable 


subsys 


Internal  Variables 


e 


Where  Typedef  Declared 


int  I  Standard 


pointer  to  VehicleSubsystems  /simnet/common/include/prot 

ocol/p  data.h 


Function 


fail  reincarnation 


controls  restore  controls 


vision  restore  all  blocks 


fail  clear  subsys  bit 


fail  aet  delta  subsystems 


network  send  status  chanae 


event  aet  eventid 


Calls 


Where  Described 


Section  2.5.4.12.1 


Sections  2.2.2,  2.3.2.  and  2.4.2 


Sections  2.2.6.4.3.  2.3.6  3.2,  and  2.4.5.1 


Section  2.5.4.14.9 


Section  2.5.4.14.7 


Section  2.1.1.3.1.62.1 


Section  2.6.9.1.2 


Table  2.5-140;  repair_all_systems  Information. 
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2.5.4.19.8  repai  r_start_self_repai  r 

This  routine  allocates  and  starts  the  self-repair  timers  when  a  system  with  self-repair  timers 
has  a  failure. 


Parameter 


system  number 


time  to  reoair 


lEiT] 


Parameters 


Where  Typedef  Declared 


Standard 


Standard 


Variable 


timer  to  use 


lElTi! 


internal  Variables 


e 


Where  Typedef  Declared 


Standard 


Standard 


Function 


timers  free  timer 


timers  set  null  timer 


timers  aet  timer 


Calls 


Where  Described 


Section  2.6.3.5.1 


Section  2.6.3.14.1 


Section  2.6.3.6.1 


Table  2.5-141:  repair_start_self_repair  Information. 

2.5.4.20  s_curr_cond.c 

(ysimhet/release/src/vehicle/libsrc/libfail/s_curr_cond.c) 


Includes; 


"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sfail  loc.h" 
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2.5.4.20.1  getjeaurr_condUion 

Stochastic  failures  de^nd  upon  the  condition  of  the  vehicle.  The  condition  is  determined 
by  the  mean  miles  betvween  failures  (MMBF)  and  the  maintenance  level  of  the  vehicle.  If 
the  MMBF  is  lowo^,  the  probability  that  d^age  will  occur  increases.  A  maintenance 
level  is  assigned  to  vehicle  bas^  on  the  age  of  the  vehicle  (i.e.  a  brand  new  tank  is 
assigned  the  lowest  msaintenance  level  of  1  and  a  5+  years  old  ta^  is  assigned  the  highest 
maintenance  level  of  iS).  Note  that  a  maintenance  level  of  1  is  assumed  when  initialing. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

best  mmbf 

int 

Standard 

maint  level 

int 

Standard 

i  Return  Values  1 

Return  Value 

Meanlna 

best_mmbf 

main  level  ratiosfmaint  level] 

int 

the  current  condition  of 
vehicle 

1  Errors  1 

Error 

Reason  for  Error 

stderr 

FAIL:  aet  curr  condition:  invalid  maint  level 

Tabl«  2.5-142:  get_curr_conditlon  Information. 


2.5.4.21  s_eTenit.c 

(ysimhet/tefeease/src/vehicIeAibsrc/libfail/s.event.c) 


Includes: 

"stdio.h" 

"math.h" 

"sim_types.lh" 

"sim_dfcs.ln" 

"sim_macrojs.h" 

"status.h" 

"failJoc.h" 

"sfailJoc.h;" 

"libnetwoifc.h" 

"libeventh" 

"mass_stdc..^" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"librva.h" 
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2.5.4.21.1  sfail_event_occurred 

This  routine  gets  called  when  the  stochastic  failures  event  has  occurred.  This  event  is 
usually  either  tiiat  the  vehicle  has  traveled  a  certain  distance  or  a  certain  number  of  rounds 
of  gunfire  have  been  fired  by  the  vehicle.  This  routine  checks  to  see  that  the  event  has 
occurred,  rolls  the  dice,  and  checks  the  failure  table  for  the  appropriate  failure.  A  message 
is  sent  on  the  network  indicating  any  failures. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

curr  event 

iht 

Standard 

1  Internal  Variables  I 

Variable 

Where  Tvpedef  Declared 

system  num 

reaister  int 

Standard 

percent 

reqister  int 

Standard 

sub  sub 

pointer  to  reaister  FAIL  TEST 

Section  2.5.4.15 

subsys 

pointer  to  VehicleSubsystems 

/simnet/common/include/prot 
ocol/p  data.h 

1  Errors  1 

Error 

Reason  for  Error 

stderr 

•  sfail  in  subsystem:  # 

•  sfail:  system  is  broken 

1  Calls  1 

Function 

Where  Described 

r/ILdice 

Macro  defined  in 

/simnet/common/include/Qlobal/sim  macros,  h 

rand 

Section  2.5.4.18 

fail  system  is  broken 

Section  2.5.4.8  2 

fail  oet  delta  subsystems 

Section  2.5.4.14.7 

network  send  status  chance 

Section  2.1.1.3.1.62.1 

Table  2.5>143:  sfail  event  occurred  Information. 


1065 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.5.4.22  s_fixed.c 

(ysiinhet/release/src/vehicle/libsic/libfail/s_fixed.c) 


Include: 

"stdio.h: 

"inath.h" 

"sim_types.h" 

’'sim_<tfns.h: 

"sim_macros.h" 

"sfailJoc.h" 

2.5.4.22.1  sfail_f  ixed_good_as_new 


Ibis  routine  sets  the  cunent  condition  for  a  replaced  subsystem  to  a  maintenance  level  of  1. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

subsystem 

int 

Standard 

Calls 

Function 

Where  Described 

aet  curr  condition 

Section  2.5.4.20.1 

Table  2.5<144:  sfaiI_fixed_good_as_new  Information. 


2.5.4.23  sjnit.c 

(ysimhet/rclease/src/vehicle/libsrc/libfail/s_iniLc) 


Include: 

"stdio.h" 

"math.h"  (Simnet  Butterfly  Machine  only) 
"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"simstdio.h" 

"UbfaiLh" 

"fail.h" 

"sfailJoc.h" 

Defines: 

OOMMENT_SlZE 


1066 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.5.4.23.1  sfaiMnit 

This  routine  sets  up  and  initializes  the  stochastic  failures  damage  table.  A  vehicle  is 
assumed  to  brand  new  with  a  maintenance  level  of  1  when  initialized. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

sdam  file 

pointer  to  ch?'- 

Standard 

num  sub  sys 

int 

Standard 

num  maint  levels 

int 

Standard 

veh_maintjevels[] 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

fp 

pointer  to  FILE 

int 

Standard 

system  num 

int 

Standard 

num  stalls 

int 

Standard 

curr  mmbf 

int 

Standard 

event 

int 

Standard 

sub  sub  sys 

pointer  to  FAIL  TEST 

Section  2.5.4.15 

char 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

stderr 

-  PANIC  -  cam  open  damage  file 

-  FAIL  -  insufficient  memory  for  sfail  tables 

-  FAIL  --  unexpected  eof  in  file 

1  Calls  1 

Function 

Where  Described 

aet  curr  condition 

Section  2.5.4.20.1 

Table  2.5-145:  sfail  init  Information. 
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2.S./4.24  sfail  loc.c 

(ysiinnet^lease/src/vehicle^bsrc/libfail/sfail_loc.c) 


"stdio.h" 

•'math.h" 

"sim_types.h" 

"sim_dfns.h" 

''sim_inacros.h" 

"sfail_loc.h" 

”fail.h" 

Dedffizations: 

maint_level_ratios[MAX_NUM_MAINT_LEVELS] 

--  sets  the  maintenance  levels  into  ratios.  The  maintenance 
levels  are  all  relative  to  maint_level_ratios[l],  which  is  equal 
to  1.0.  The  other  maintenance  levels  have  ratio  equivelants, 
such  that  if  maint_level_ratios[n]  =  0.5,  the  vehicle  is  twice 
as  likely  to  suffer  a  stochastic  failure.  maint_level_ratios[n] 
corresponds  to  maintenance  level  n,  therefore 
maint_level_ratios[0]  =  0.0,  since  no  maintenance  level  0 
exists* 

sub_system[MAX_NUM_SUBSYSTEMS] 

NUM_MAINTJLEVELS 

NUM_SUB_SYSTEMS 

Dcfiifies* 

'  MAX_NUIM_SUBSYSTEMS 

2.5.4.25  sfail  loc.h 

(ysimnet^lease/src/vehicle/libsrc/libfail/sfail_loc.h) 


Includes: 

"faU.h" 

Defimes: 

SFAIL_DEBUG 

MAX_NUM_MAINT_UEVELS 

Typesdefs: 

sfail_type  --  the  structure  of  the  stochastic  failure  array  entry,  where: 

mmbf  is  die  mean  miles  between  failures  when  new, 
curr  mmbf  is  the  current  mean  miles  between  failures, 
event  is  the  event  that  causes  a  stochastic  failures  check, 
failjist  is  the  list  of  failures  that  may  occur 

Exteimal  declarations: 

sub_system[] 

NUM_MAINT_LEVELS 

NUM_SUB_SYSTEMS 

maintJeveLratiosf] 


1068 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.5.4.26  sfail  mnt_cond.c 

(ysimnet/release/src/vehicle/libsn;/libfai]/sfail_nint_cond.c) 


Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sfail_loc.h" 

The  variable  init_maint_condition  is  declared. 


2.5.4.26.1  sfail_maint_cond 

This  routine  returns  the  current  maintenance  condition  of  the  vehicle. 


1  Return  Values  1 

Return  Value 

Meanina 

1 

int 

the  initial  maintenance  level  is 
set  at  1 ,  signifying  a  brand  new 
vehicle 

Init  maint  condition 

int 

the  maintenance  level 

I  Errors  1 

Error 

Reason  for  Error 

stderr 

PANIC  -  In  sfail  ~  bad  inilial  mainf  level 

Table  2.5«146:  sfail_maint_cond  Information. 

2.5.4.26.2  sfaiI_maintenance_condition 

This  routine  is  called  to  change  the  mainetance  level  for  the  vehicle.  In  this  routine,  the 
current  level  is  set  to  the  level  passed  in  the  parameter,  condition. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

1  condition 

register  int 

Standard 

1  Internal  Variables  1 

1  Variable 

Where  Typedef  Declared 

Isvtem  num 

register  int 

Standard 

1  Errors  1 

1  Error 

Reason  for  Error 

1  stderr 

PANIC  ~  in  sfail  -  bad  maint  level 

Calls 

1  Function 

Where  Described 

laet  curr  condition 

Section  2.5.4.20.1 

Table  2.5>147:  sfail  maintenance  condition  Information. 
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2.5.5  libturret 

(ysimnelAelease/src/vehicle/libsrc/Iibtunet  [libtunet]) 

More  fidelity  is  required  of  the  model  of  the  turret  and  gun  than  is  required  for  the  other 
moving  components.  The  basic  model  for  the  Ml  and  M2  turrets  is  found  in  libturret 
Functions  are  provided  to  traverse  the  turret  and  elevate  the  gun.  These  functions  perform 
stabilization  of  the  gun  as  well.  Messages  are  put  on  the  netwcn-k  by  libturret  to  inform  the 
world  of  tiuret  position. 

2.5.5. 1  libturret.h 

(ysimnet^lease/src/vehicle/libsrc/iibtunet/libtuiTCth) 

Ibis  file  contains  the  Turret  Simulation  Module  and  includes  the  stabilization  system  and 
gunner's  primary  sight. 

Includes: 

"basic.h" 

External  Declarations: 
gps_in_world 
hull_to_turret 
turret_to_hull 
turret_to_sight 
sight_to_turret 
sight_to_world 
gun_to_turret 
turret_to_gun 

set_turret_vars() 

tur'ret_elevate_gun() 

turret~elevate”sight() 

turret~get_aziihuth_str() 

turret~get”gun_tipO 

turret“get”guir to  worId() 

turret~get_ref_rndT) 

turret~get”network_azimuth() 

turret3get”network~elevation() 

turret^^al^azimuthO 

turret~get_totaI_turret__sIew_rate() 

turret~get”totargun_eTev_rate() 

turret~get”sighrin_worl<r() 

turret~get_stab^chahges( ) 

turret~move_azIhiuth() 

turret”move~elevation() 

turret~nuU  azimuth_ind 

turret^pos  lnit() 

turret~sen7_azimuth_ind() 

turret~set_stab_sys() 

turret~setZstab”vector() 

turretZstopsjnTtO 

turretZsyncZhun_with_sight 

turretZsybnc_sight_with_gun 

turretZupdatt_check() 

turretZupdate_rva() 
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2. 5. 5. 2  turret.c 

(Vsininet/release/src/vehicle/libsrc/libtunel/tuTreLc) 

Contains  the  simulation  of  generic  turret  functions.  This  file  maintains  the  matrices  which 
contain  the  orientations  of  Ae  turret  and  gun . 

Includes: 

"stdio.h" 

"math.h'’ 

"sim_types,h" 

"sim_^ns.h" 

"sim_macros.h" 

"basic.h" 

"libmatrix.h" 

"Ubkin.h" 

"UbhuU.h" 


Defines: 

TURRET_DEBUG 
TURRET_FAILURES_DEBUG 
STAB.DEBUG 

ON_TOP_STOP 
ON_BOTTOM_STOP 
NOT_STOPPED 
TURRET_AZI_DEGS 
TURRET_AZI_CHANGE 
GUN_ELEV_DEGS 
GUN_ELEV_CHANGE 

Declarations: 

hull_to_turrBt 
tuiret_to_hull 
sight_to_turret 
sight_to_world 
turret_to_sight 
gun_to_tunet 
turret_to_gun 
SIGHT_MAX_ELEV 
SIGN_MIN_ELEV 
GUN_MAX_ELEV 
GUN_MIN_ELEV 
sight_on_stop 
gun_on_stop 

sight_in_hull  -  normalized  vector  used  by  the  stabilization  system  (sight  in 
hull  coordinates) 

sight_in_world  -  normalized  vector  used  by  the  stabilization  system  (sight  in 
world  coordinates) 

turret.azimuth  ••  the  number  of  radians  that  the  tunet  is  rotated  in  azimuth 
relative  to  the  hull.  An  increasing  angle  means  a  clockwise 
rotation.  0.0  means  that  the  turret  is  aligned  with  the  hull. 
0.0  <=  turret  azimuth  <  2*PI 


-  options  for  sight_on_stop  and  gun_on_stop 

-  in  degrees 

-  in  degrees 
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total_turret_slew_rate  -  in  radians  per  tick 

total_gun_elev_rate  --  in  radians  per  tick 

gun_elevati(»8  —  the  number  of  radians  that  the  gun  is  elevated  relative  to  the 

hull.  An  increasing  angle  means  an  elevation.  0.0  means 
that  the  gun  is  parallel  to  the  tank  hull. 

0.0  <=  gtm_elevation  <  2*PI 

time_to_updaitejrvsa 

deltajelevation 

delta_azimuth 

azimuth_str[S0] 

azimuth_range_foim)at 

send_grid_azmiuth 

w_to_g_mat 

super_elev_nsat 

le^_track_mat 

turret_get_slope_.ind() 

turret”get~ref  iindO 

turret_calc_azlimuth() 

turret_get_stab  changes() 

turret_move_az»iuth() 

elevate_system(> 

set_turFet_vars(§ 

2. 5. 5. 2.1  turret_ataips__init 

This  routine  initializes  the]k>cations  of  the  gun  and  sight  stops.  All  parameters  represent  the 
sines  of  the  angles. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

sight_max 

REAL 

/simnet/common/include/glob 
al/sim  tvoes.h 

^ht_min 

REAL 

/simnet/common/include/glob 
al/sim  types,  h 

^n_max 

REAL 

/simnet/common/inciude/glob 
al/sim  types.h 

gun_min 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

Table  21.5*148:  turret_stops_init  Information. 
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2. 5. 5. 2. 2  turret_pos_init 

This  routine  initializes  the  tunet  azimuth  variables,  initializes  the  stabilization  vectors  so  that 
the  stabilization  system  can  be  used  as  soon  as  ne^ed,  and  creates  the  identity  matrices. 
The  parameter,  init  jurret  azimuth,  represents  the  initial  azimuth  of  the  turret  relative  to  the 
hull  in  a  circle  ranging  in  value  from  0  to  Oxffffffff,  where  0  is  aligned  perfectly  with  the 
front  of  the  hull,  and  the  values  increase  as  the  turret  is  initialized  in  a  counterclockwise 
direction  finom  the  heading  of  the  hull.  The  variable,  rad  azimuth,  represents  the  azimuth  in 
radians,  clockwise  from  Ae  hull. 


Parameters 


Parameter 

Type 

Where  Typedef  Declared 

init  turret  azimuth 

usiqned  int 

Standard 

1  Internal  Variables 

Variable 

Where  Typedef  Declared 

rad.azimuth 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls 

Function 

Where  Described 

mat  rot  init 

Section  2.6.2.47.1 

mat  transpose 

Section  2.6.2.51.1 

mat  idem  init 

Section  2.6.2.31.1 

Table  2.5-149: 


turret_pos_init  Information. 


2. 5. 5. 2. 3  turret_set_stab_sys 


This  routine  is  called  after  the  turret  simulation  is  completed.  After  the  turret  has  moved, 
the  vector  it  will  point  to  is  saved  to  be  set  in  the  next  tick.  It  forms  two  vectors  which 
represent  the  sight  vector  in  both  hull  and  world  coordinates.  The  sight  to  world  matrix  is 
generated  in  the  process.  This  is  called  by  terrain_get_stab_elev()  and 
terrain_get_stab_rot(). 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

h_to_w 

T_MATRIX 

/simnet/common/include/glob 
al/sim  types. h 

1  Calls  1 

Function 

Where  Described 

vec  init 

Section  2.6.2.61.1 

mat  mat  mul 

Section  2.6.2.32.1 

vec  mat  mul 

Section  2.6.2.56.1 

mat  copy 

Section  2.6.2.39.1 

kinematics  pet  h  to  w 

Section  2.5.8.2.2 

Table  2.5-150;  turret_^set_stab_sys  Information. 
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2. 5. 5. 2. 4  turret_set_stab_vector 

This  routine  is  not  used  in  the  version  6.6  release. 

2.5 .5 .2 .5  turret_get_stab_changes 

After  the  hull  is  moved,  and  before  the  turret  is  moved,  this  routine  is  called  by 
turret  moveO  to  determine  how  far  the  turret  should  be  rotated  and  how  high  the  gun 
shoulrfbe  elevated,  in  order  to  compensate  for  hull  movement  in  the  current  frame.  The 
parameter,  azimuthjrou  represents  the  sine  in  radians  of  the  rotation.  The  variables 
old_sight  and  new  sight  represent  the  angles  the  turret  must  move  to  in  order  to  align  the 
sight  to  the  last  position. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

azimuth_rot 

pointer  to  REAL 

/simnet/common/include/gtob 
al/sim  tvpes.h 

elev_rot 

pointer  to  REAL 

/simnet/common/include/giob 
al/sim  tvoes.h 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

old_sight 

register  pointer  REAL 

/simnet/common/include/giob 
al/sim  tvoes.h 

new_sight 

register  pointer  REAL 

/simnet/common/include/giob 
al/sim  tvoes.h 

old_dot_new 

register  REAL 

/simnet/common/include/giob 
al/sim  tvoes.h 

sqr_norm_A_norm_B 

register  REAL 

/simnet/common/include/giob 
al/sim  tvpes.h 

sqr_cos_rotation 

register  REAL 

/simnet/common/include/giob 
al/sim  tvoes.h 

sin_rotation 

register  REAL 

/simnet/common/include/giob 
al/sim  tvoes.h 

x_prod 

register  REAL 

/simnet/common/include/giob 
al/sim  tvoes.h 

1  Calls  1 

Function 

Where  Described 

vec  mat  mul 

Section  2.6.2.56.1 

kinematics  aet  w  to  h 

Section  2.5.8.2.2 

Table  2.5-151:  turret_get_stab_changes  Information. 
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2. 5. 5. 2. 6  turret  move  azimuth 


This  routine  moves  the  turret  in  azimuth  given  the  total  slew  rate.  The  change  over  the 
current  tick  widi  respect  to  the  world  is  added  to  the  azimuth.  The  RVA  table  is  updated. 
The  turret  to  hull  matrix  is  updated  and  the  new  azimuth  is  calculated. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

totaLslew_rate 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

rot_matrix 

T_MATRIX 

/simnet/common/include/glob 
al/sim  types.h 

l_to_h 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  types.h 

h_to_t 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  types.h 

1  Calls  1 

Function 

Where  Described 

mat  rot  init2 

Section  2.6.2.33.1 

mat  mat  mul 

Section  2.6.2.32.1 

mat  transpose 

Section  2.6.2.51.1 

Table  2.5-152;  turret  move  azimuth  Information. 
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2. 5. 5. 2. 7  turret_move_elevation 

This  routine  moves  the  gun  in  elevation,  given  the  total  elevation  rate.  In  addition  to 
elevating  the  gun,  this  routine  is  also  responsible  for  checking  to  make  sure  that  the  gun  is 
not  moving  too  fast.  It  also  checks  to  see  that  sufficient  hydraulic  pressure  is  available 
before  actually  elevating  the  gun.  If  the  gun  is  slaved  to  sight,  the  gun  is  aligned  with  the 
a%hL  X  =  sin(x)  approximation  is  used  in  the  rotation  matrix. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

totaLelev_rate 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

oun  slaved  to  siaht 

int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

siQht_elev_mat 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

s_e_mat 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

l_lo_sight 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

Calls 

Function 

Where  Described 

mat  rot  init2 

Section2. 6.2. 17.1 

nxat  mat  mul 

Section  2.6.2.32.1 

mat  transpose 

Section  2.6.2.51.1 

mat  copy 

Section  2.6.2.39.1 

Table  2.5-153:  turret  move  elevation  Information. 
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2. 5. 5. 2. 8  turret_elevate_sight 

This  routine  returns  TRUE  if  the  elevation  was  successful,  and  FALSE  if  the  sight  hits 
either  the  top  or  bottom  stop. 


Parameter 


elev  rate 


11273 


register  REAL 


Parameters 


Where  Tvpedef  Declared 


/simnet/common/include/glob 
al/sim  tvDes.h 


Return  Value 


sight_on_stop 
NOT  STOPPED 


IE27^ 


Return  Values 


Meanin 


if  TRUE,  the  elevation  was 
successful; 

if  FALSE,  the  sight  hit  either 
the  top  or  bottom  stop 


Function 


elevate  svstem 


Calls 


Where  Described 


Section  2.5.5.2.10 


Table  2.5-154:  turret_elevate_sight  Information. 

2. 5. 5. 2. 9  turret_elevate_gun 

This  routine  returns  TRUE  if  the  elevation  was  successful,  and  FALSE  if  the  gun  hits 
either  the  top  or  bottom  stop. 


Parameters 


Parameter 


elev  rate 


register  REAL 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/sim  tvpes.h 


Return  Value 


gun_on_stop  == 
NOT  STOPPED 


IE27!] 


Return  Values 


Meanin 


if  TRUE,  the  elevation  was 
successful; 

if  FALSE,  the  gun  hit  either 
the  top  or  bottom  stop 


Function 


elevate  svstem 


Calls 


Where  Described 


Section  2.5.5.2.10 


Table  2.5-155:  turret_elevate_gun  Information. 
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2.5.5.2.10  elevate_systeiii 

This  routine  is  called  by  the  routine  elevate_sightO  to  calculate  the  sight  elevation  and  by 
the  routine  elevate_mnO  to  calculate  the  gun  elevation.  The  system  (either  the  gun  or  the 
sight)  is  moved  to  me  desired  elevation.  The  routine  checks  to  see  if  the  system  has  hit  one 
of  the  stops.  If  the  desired  elevation  is  beyond  a  stop,  the  system  is  moved  to  the  stop. 

and  to  check  for  the  system  hitting  the  stops. 


elevjimount 

top_stop 

bottom_stop 

stop_statua 


--  the  sine  of  the  desired  elevation  angle 

-  the  sine  of  the  top  stop  angle 

-  the  sine  of  the  bottom  stop  angle 

--  whether  the  system  is  at  one  of  the  stops 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

turret_to_system 

register  T_MATRIX 

/simnetycommon/include/glob 
al/sim  tvpes.h 

system_to_turret 

register  T_MATR1X 

/simnet/common/include/glob 
al/sim  tvpes.h 

elev_amount 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

top_stop 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

bottom_stop 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

stop  status 

pointer  to  int 

Standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

system_elev_mat 

T.MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

s_e_mat 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

mat  rot  init2 

Section  2.6.2.33.1 

mat  mat  mul 

Section  2.6.2.32.1 

mat  transpose 

Section  2.6.2.51.1 

Table  2.5>156:  elevate_system  Information. 
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2.5.5.2.11 


turret_sync_gun_with_sight 


This  routine  is  called  by  the  vehicle  specific  turret  code  to  move  the  gun  and  the  sight  back 
together  after  they  have  been  apart,  given  the  offset  of  the  gun  from  the  sight,  difference  is 
the  sine  of  the  angle  between  the  gun  and  the  sight.  An  example  of  when  this  routine  is 
called  is  after  the  gun  has  swung  low  over  the  back  deck,  using  back  deck  clearance. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

difference 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

difference_matrix 

T_MATRIX 

/simnet/common/include/glob 
al/sim  types.h 

d_mat 

T_MAT_PTR 

/simnet/common/include/glob 
al/sim  types.h 

1  Calls  1 

Function 

Where  Described 

mat  rot  init2 

Section  2.6.2.33.1 

mat  mat  mul 

Section  2.6.2.32.1 

mat  transpose 

Section  2.6.2.51.1 

Table  2.5-157:  turret_synch_gun_with_sight  Information. 
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mS.S.l .  1 2  turret_syncb_siglit_with_gun 

Wi&  s  routine  is  called  by  the  vefaide  specific  tunet  code  to  move  the  sight  and  the  gun  back 
tqieether  after  they  have  been  apan,  i^ven  the  offset  of  the  sight  from  die  gun.  For 
CMOL’Tiple,  after  the  gun  has  hit  itsKjp  stop,  the  sight  may  still  be  able  to  move  up,  even 
dhRijtgh  it  should  not.  This  rounae  will  used  to  correct  the  instantaneous  problem  that 
xadks  from  the  gun  hitting  its  stop,  difference  is  the  sine  of  the  angle  between  the  gun  and 
ttar  sitight. 


1  Parameters  I 

Psra^meter 

Tip® 

Where  Typedef  Declared 

difec;^ence 

AEAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

lONternal  Variables 

Wfaeble 

Tip® 

Where  Typedef  Declared 

cfifbfrience  .matrix 

TjyiATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

djn^ 

TJtlAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

Calls 

Ftifc.^tlon 

Where  Described 

rntf  iMot  init2 

Section  2.6.2.33.1 

rntf  mul 

Section  2.6.2.32.1 

ma  ^transpose 

Section  2.6.2.51.1 

Table  2.5-158:  liirret_sync_sight_with_gun  Information. 
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2.5.5.2.13  turret_get_g_to_w 

This  routine  is  called  by  gunnery  when  the  gun  is  about  to  be  fired.  It  determines  the  gun 
to  world  matrix,  taking  into  account  the  lead  azimuth  and  super  elevation  of  the  gun  at  the 
moment  of  firing  (these  variables  are  obtained  by  calls  to  the  ballistics  computer). 

First,  the  turtet_to_world  matrix  is  found  by  multiplying  turret_to_hull  by  hull_to_world. 
This  matrix  is  rotated  in  the  plane  of  the  turret  to  compensate  for  the  lead  azimuth.  Then, 
the  gun  is  elevated,  accounting  for  both  the  sight  elevation  and  the  super  elevation  from  Ae 
ballistics  con^uter.  The  rotations  must  be  calculated  in  this  order,  rather  than  starting  with 
the  gps  vector,  rotating  for  lead  azimuth,  and  elevating  for  superelevation  since  the  rotation 
for  lead  azimuth  is  done  around  the  gps  Z  axis,  not  the  turret  Z  axis.  Since  problems 
would  occur  when  the  gun  tube  was  highly  elevated,  this  set  of  rotations  is  not  being  used. 
Note:  the  ballistics  system  is  not  meant  to  adjust  for  the  tank  pitched. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

g_to_w 

register  T_MATRIX 

/simnet/common/include/glob 
ai/sim  tvpes.h 

lead_azimuth 

register  REAL 

/simnet/common/include/glob 
al/sim  tvoes.h 

super_elevation 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

error_offset 

register  pointer  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

wJo_g 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

super_elev 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

leadjrack 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

mat  mat  mul 

Section  2.6.2.32.1 

kinematics  qet  w  to  h 

Section  2.5.8. 2.1 

mat  rot  init2 

Section  2.6.2.33.1 

mat  transpose 

Section  2.6.2.51.1 

turret_get_g_to_w  Information. 
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2.5'.iS.2.14^  turret_get_network_elevatlon 

Unsi^KNitiaeiis  called  by  the  network  to  get  the  gun  elevation.  It  returns  an  unsigned  long 
witkih  repaess-atts  the  gun  elevation,  where  0  means  the  gun  is  parallel  with  the  hull  of  the 
taflik  ?  inaeukisg  as  the  gun  elevates. 


Becaause  of  Ci^nstraints  on  precision  in  the  Butterfly  machine,  this  routine  computes  the 
elenk'tkm  ashn^  the  angle  (by  dividing  the  unsigned  long  value  by  4PI  rather  than  2PI), 
then  rmult^^^g  by  2  by  left  shifting  by  1. 


1  Internal  Variables  1 

Variaifible 

Type 

Where  Tvpedef  Declared 

lortgjtelev 

Angle 

/simnet/common/include/glob 

al/basic.h 

1  Return  Values  1 

iReluirn  Vafue 

Meaning 

1  Anale  1 

the  gun  elevation 

Talale  2^-160:  turret_get_network_elevation  Information. 

2 . 5 .  M .  2 . 15  tuiTet_get_network_azimuth 

This  iroutine  itt  called  by  the  network  to  get  the  turret_azimuth.  It  returns  an  unsigned  long 
whichi  represents  the  turret  azimuth,  where  0  means  that  the  turret  is  aligned  with  the  front 
of  ihec  tank,  iiRcreasing  as  the  turret  rotates  counterclockwise  as  viewed  looking  down  on 
thetaink. 

Becaiuse  of  ccanstraints  on  precision  in  the  Butterfly  machine,  this  routine  computes  the 
azimuith  as  ^If  the  angle  (by  dividing  the  unsigned  long  value  by  4P1  rather  than  2PI),  then 
muMf  plying  b  'y  2  by  left  sUfling  by  1. 


1  Internal  Variables  1 

Varl8^ble 

Where  Typedef  Declared 

long  fazi 

Angle 

/simnet/common/include/glob 

al/basic.h 

1  Return  Values  1 

Return  Vaiif« 

Meaning 

lono_fazi 

Angle 

the  turret  azimuththe  turret 
azimuth 

Ts'^ble  2.5*161 :  turret_get_network_azimuth  Information. 
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2.5.5.2.16 


turret_get_ref_ind 


This  routine  is  called  to  tell  controls  the  azimuth  of  the  turret  relative  to  the  hull  in  radians. 


1  Return  Values  1 

Return  Value 

Meaning 

turret  azimuth 

REAL 

The  turret  azimuth  in  radians 

Table  2.5-162:  turret_get_ref_ind  Information. 

2.5.5.2.17  turret_null_azimuth_ind 
This  routine  sets  send_grid  azimuth  to  FALSE. 

2.5.5.2.18  turret_send_azimuth_ind 
This  routine  se»s  sendjgrid  azimuth  to  TRUE. 

2.5.5.2.19  tu  rret_get_azimut h_st r 

This  routine  determines  whether  to  notify  controls  of  the  turret  azimuth  relative  to  the 
world.  Controls  should  be  notified  when  the  vehicle  is  stopped  and  the  commander  has 
pushed  the  appropriate  button.  The  azimuth  is  calculated  and  converted  to  a  character 
string. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

azimuth 

REAL 

/simnet/common/includfc/glob 
al/sim  types.h 

azi  str 

register  pointer  char 

Standard 

1  Return  Values  1 

Return  Value 

Tvne 

Meaning 

azLstr 

pointer  to  char 

The  turret  azimuth  as  a 
character  string 

1  Calls  1 

Function 

Where  Described 

turret  calc  azimuth 

Table  2.5-163:  turret_get_azimuth_str  Information. 
2.5.5.2.20  turret_update_check 

If  timejo_update_rva  is  non-zero,  the  RVA  is  updated. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

time  to  update  rva 

int 

Standard 

Table  2.5-164:  turret_update_check  Information. 
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2.5.5.2.21  turret_update_rva 


This  routine  sets  the  elevation  and  azimuth  changes  to  0.0,  and  sets  time  Jo  update  _rva 
equal  to  FALSE. 


2.5.5.2.22  turret_get_sight_in_world 
This  routine  returns  the  sight_in_world. 


1  Return  Values  1 

Return  Value 

Meanina 

sightJn_world 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvoes.h 

Table  2.5-165:  turret_get_sight_in_worId  Information. 
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2.5.6  libsusp 

^simnet/telease/src/vehicle/libsrc/libsusp  [libsusp]) 

The  suspensions  of  the  Ml  and  M2  simulators  are  simulated  by  assuming  a  suspension 
consisting  of  one  linear  spring-damper  assembly  for  each  tracl^  and  one  rotational  spring- 
damper  assembly  between  the  hull  and  the  undercarriage.  This  model  accommodates  one 
linear  degree  of  fteedom  in  the  Z  direction  (up/down),  and  two  rotational  degrees  of 
freedom,  pitch  and  roll.  This  functionality  is  realized  by  one  CSU,  libsusp. 

This  library  provides  services  for  setting  the  damped  natural  frequency,  and  damping  ratio 
for  each  of  the  three  assemblies,  setting  the  acceleration  of  the  chassis,  and  setting  a  gim 
force  reaction.  These  services  are  used  by  libbigwheel  which  maintains  the  relationship 
between  the  vehicle  and  the  terrain. 

2.5.6. 1  gun  fired.c 

(/simnet^lease/src/vehicle/libsrc/libsusp/gun_fired.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"susp_loc.h" 

2. 5. 6. 1.1  suspension_gun_fired 

This  routine  is  called  to  model  the  suspension  when  the  gun  is  fired.  out_susp  is  the 
structure  to  be  operated  on;  tjcos  is  the  cosine  of  the  gun  angle  with  respect  to  the  hull; 
t  sin  is  the  sine  of  the  gun  angle  with  respect  to  the  hull.  The  gun  Jired  flag  is  set  to 
TRUE. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

out  SUSP 

pointer  to  int 

Standard 

t_cos 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

t_sin 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

I  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

loc  SUSP 

pointer  to  SUSPENSION 

SUSP,  loc.h 

Table  2.5-166:  suspension_gun_fired  Information. 


BBN  Systems  «md  Tecfenologies 


Vehicles  CSQ 


2. 5. 6. 2  Blbsusp..ih 

(/simmet/rBkaBse^sic/vehicle/libsrc/libsusp/libsusp.h) 

External  fiinctiron  declaasadons: 

suspRensiem^un^fired  0 

suspiensiomO  ~ 

susiii»ensioiL;_jparains() 

suspNensionJnit() 

suspensioiii_uninit() 

susp«nsioii._veh_init() 

suspensioii|_accderation_is() 

2.5. 6.3  anisp_aecel.c 

(/smunet^iBsese/siic/vehicle/libsrc/Iibsusp/susp.accel.c) 


Includes: 

"sttfiio.h" 

"matfii-h" 

''sinx_dfns.h;”' 

"siin._macrosLh" 

"siin._types.K* 

"susp_loc.h:*’ 


2 . 5 . 6 . 3 . 1  suspemsion_acceleration_is 

This  routine  passes  imt&e  vehicle  acceleration,  occe/,  to  the  suspension  data  structure, 
outjusp. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

out  SUSP 

pointer  to  int 

Standard 

aocel 

REAL 

/simnel/common/include/glob 
al/sim  types. h 

Taible  2.S-167: 
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2.5. 6.4 


susp_init.c 

(/siinnet/release/src/vehicle/libsicAibsusp/susp_init.c) 


Includes: 

"stdio.h" 

’•inath.h" 

"sim.dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"susp_loc.h" 

2. 5. 6. 4.1  suspension_uninit 

This  routine  resets  the  suspensionjnited  field  of  the  local  suspension  data  structure  to 
FALSE.  If  the  suspension  was  not  initialized  to  begin  with,  a  message  "PANIC  -  tried  to 
uninit  non-inited  workspace"  is  printed.  The  suspension  is  not  really  uninitialized;  a 
variable  is  reset 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

out  SUSP 

pointer  to  int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

loc  SUSP 

pointer  to  SUSPENSION 

SUSP  loc.h 

Table  2.5-168:  suspension_uninit  Information. 


2. 5. 6. 4. 2  suspension_init 


This  routine  initializes  the  suspension,  pointing  the  local  suspension  data  structure  to  the 
passed  parameter,  out  susp.  If  memory  does  not  exist,  the  routine  allocates  this  stmcture, 
then  initializes  some  of  the  elements  in  the  structure. 


1  Parameters  1 

1  Parameter 

Where  Typedef  Declared 

lout  SUSP 

pointer  to  pointer  to  int 

Standard 

Internal 

Variables 

Variable 

Type 

Where  Typedef  Declared 

loc  SUSP 

pointer  to  SUSPENSION 

1  Calls  1 

Function 

Where  Described 

dynamics  filter  init 

Section  2.5.4.7.1 

suspension  uninit 

Section  2.5.6.4.1 

Table  2.5-169:  suspension_init  Information. 
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2. 5. 6. 5  susp_params.c 

(/simnet^lease/sic/vehicle/libsrc/libsusp/susp_params.c) 


fincludes: 

"stdio.h’’ 

"math.h" 

’’sim_dfns.h" 

”sim_macros.h" 

"sim_types.h" 

"libinatrix.h" 

"susp_loc.h" 

2.5. 6. 5.1  suspension_params 

This  routine  sets  up  the  suspension  parameters.  The  suspension  is  modeled  as  a  second 
omfer  filter  based  on  the  natural  frequency  and  damping  ratio.  The  lever  arm  and  angle 


—  Rotational  suspension  natural  frrequency  (radians) 

—  Rotational  suspension  damping  ratio 

--  Side  suspension  natural  frequency  (radians) 

--  Side  suspension  damping  ratio 
--  Meters 

"  Maximum  angle  limit  -9  degrees  .7  m  by  4.5  m 
--  The  force  generated  for  rocl^g  the  gun 
--  Left  side  offset  from  rear  wheel 
--  Right  side  offset  from  rear  wheel 


mmitsareseL 


r(ot_wn 

r(ot_zeta 

Sttde_wn 

sUde_2eta 

Ueverjarm 

anglelim 

giun  force 

night 


1  Parameters  ! 

P'arameter 

Type 

Where  Typedef  Declared 

OlUt  SUSP 

pointer  to  int 

Standard 

nDt_wn 

REAL 

rrot_zeta 

REAL 

siide_wn 

REAL 

/simnet/common/include/glob 
al/sim  types,  h 

siide_zeta 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

l«9ver_arm 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

anglejim 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

fflunjorce 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

lieft 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

rfight 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 
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_ 1 

Calls  1 

Function 

Where  Described 

vec  coDV 

Section  2.6.2.59.1 

Table  2.5-170:  suspension_params  Information. 
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2. 5. 6. 6  susp_simul.c 

(/simnetAclease/sicA^ehicle/libsrc/libsusp/susp_simul.c) 

Includes; 

"stdio.h" 

”math.h" 

"sim_dfns.h” 

"sim_macros.h" 

'’sim_types.h" 

”dynlib.h" 

"suspjoc.h" 

"Ubmatrix.h" 

2. 5. 6. 6.1  suspension 

This  routine  is  called  on  a  tick  by  tick  basis.  Given  a  pointer  to  the  suspension  structure, 
the  routine  determines  the  location  of  the  wheels  and  how  high  they  are  above  the  terrain. 
The  dynanucs  package  is  not  initialized.  The  rotation  (forw^  to  back  rocking)  is  found 
as  a  product  of  the  acceleration  and  level  aim  with  a  rotational  input  added  from  the  force  of 
the  gun.  Parameters  and  variables  are  represented  as  follows; 
outjsusp  --  local  suspension  paran^ters  structure 

rear_wheel  —  Location  of  rear  wheels  in  world  coordinates;  it  is  assumed  they  are 

sitting  on  the  terrain  patch 
”  Hull  to  World  coordinate  transformation  matrix 
u  norm  -  The  normal  to  the  teirain  patch  under  the  vehicle 

cSt,aY  ~  Temporary  variables 

rotjmgle  -  Rotation  angle;  Pitch  of  the  suspension  relative  to  the  world  of  the 

vehicle 

temp  --  Temporary  storage  variable 

left  side  --  Left  side  point  of  the  tank 

rigfa_side  -  Right  side  point  of  the  tank 

forward  -  Forward  point  of  the  tank 

First,  the  offset  in  world  coordinates  is  calculated.  The  heights  in  the  plane  are  calculated 
from  the  unit  normal.  The  forward  vector  and  pitch  angle  are  calculated.  The  states  are 
updated  and  the  new  unit  normal  is  formed  relative  to  the  orientation  of  the  tank. 
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Internal  Variables 

Variable 

Typo 

Where  Typedef  Declared 

lOC  SUSD 

Dointer  to  SUSPENSION 

SUSP  loc.h 

sX 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

aY 

register  REAL 

/simnet/common/include/glob 
al/sim  types.h 

rot_angle 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

temp 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

forward 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

left_side 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

right_side 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

rotjnput 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

leftjnput 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

rightjnput 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

Calls 

Function 

Where  Described 

vec  mat  mul 

Section  2.6.2.56.1 

vec  sub 

Section  2.6.2.65.1 

vec  cross  orod 

Section  2.6.2.66.1 

dynamics  filter  uodate 

Section  2.5.7.4.3 

vec  normaiize 

Section  2.6.2.63.1 

Table  2.5>171:  suspension  Information. 
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2.S.6.7 

Includes: 


veh  init.c 

(/simnet^lease/sic/vehicle/libsrc/libsusp/veh_init.c) 


"stdio.h" 

”math.h” 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"susp_loc.h" 

"dynUb.h" 

"libmatrix.h 
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2. 5. 6. 7.1  suspehsion_veh_init 


This  routine  finds  the  relative  location  in  world  coordinates  of  the  rear  wheels  (left  side  and 
right  side),  assuming  the  wheels  are  sitting  on  the  terrain  patch.  'Die  offset  is  calculated  in 
world  coordinates,  Aen  heights  in  the  plane  from  the  unit  normal  are  calculated.  A  vector 
pointing  ahead  is  formed  (forwanl).  llie  pitch  angle  is  calculated,  and  the  states  are 
initialb^  Parameter  and  variable  are  represented  as  follows: 
out_susp  -  Local  suspension  parameters  structure 

rear_wheel  -  Location  of  rear  wheels  in  world  coordinates 

hjo_w  --  Hull  to  World  coordinate  transformation  matrix 

ujtorm  --  The  normal  to  the  terrain  patch  under  the  vehicle 


ujiorm 

rotjmgle 

temp 

l(fi_side 

right_side 

forward 


—  Rotation  angle;  Pitch  of  suspension  relative  to  the  vehicle  world 
--  Temporary  storage  variable 
--  Left  side  point  of  the  tank 
--  Right  side  point  of  the  tank 
--  Forward  point  of  the  tank 


Parameter 


out  sus 


rear_wheel 


h  to  w 


u  norm 


Parameters 


e 


inter  to  int 


VECTOR 


idt: 


T  MATRIX 


VECTOR 


Where  Tvoedef  Declared 


Standard 


/simnet/commorVinclude/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


Variable 


loc  sus 


aX 


rot_angle 


forward 


left  side 


right_side 


IE273 


Internal  Variables 


e 


register  pointer  SUSPENSION 


register  REAL 


register  REAL 


register  REAL 


VECTOR 


VECTOR 


VECTOR 


VECTOR 


Where  Typedef  Declared 


loc.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


Function 


vec  mat  mul 


vec  sub 


vec  cross  prod 


dynamics  filter  open 


Calls 


Where  Described 


Section  2.6.2.56.1 


Section  2.6.2.65.1 


Section  2.6.2.66.1 


Section  2.5.7. .4.2 


Table  2.5>172:  suspension_veh_init  Information. 
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2. 5. 6. 8  sus  loc.h 

(/simne^lease/src/vehicle/Ubsrc/libsusp/susp_loc.h) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"dynlib.h" 


The  SUSPENSION  data  structure  type  is  defined,  and  contains  the  following  fields: 


ROT_WN 

ROT.ZETA 

SEDE.WN 

SIDE.ZETA 

LEVER_ARM 

ANGLE.UM 

GUN_FORCE 

rot_suspension 

iight_suspension 

left_suspension 

Loffset 

r_offset 

gun_fired 

tunetjcos 

tunet_sin 

veh_accel 

suspension.inited 


~  rotational  suspension  natural  frequency  (in  radians) 
~  rotational  suspension  damping  ratio 
~  side  suspension  natural  fr^uency  (in  radians) 

-  side  suspension  damping  ratio 
--  in  meters 

"  approximately  9  degrees,  0.7  meters  by  4.5  meters 
--  force  of  firing  the  gun 


“  left  side  offset  from  rear  wheel 

-  ri^t  side  offset  from  rear  wheel 

-  raised  when  the  gun  is  fired 
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2.5.7  libdyn 

(/simnet/release/sic/vehicle/libsrc/libdyn  [libdyn]) 

This  libraiy  provides  simple  utilities  for  the  creation  and  maintenance  of  second  order 
filters,  a  first  order  lag  function,  integration  of  forces  and  torques  to  form  accelerations, 
integration  of  accelerations  to  fmm  velocities,  and  the  calculation  of  inertias  based  on 
rotation  rate  and  velocity.  These  facilities  are  used  throughout  the  Ml  simulation. 

2. 5. 7.1  calc  inert.c 

(/simnet^lease/src/vehicle/libsrc/libdyn/calc_ineitc) 

Includes: 

"sim_types.h" 

"sim_dfns.h" 

•'Ubmatrix.h" 

"dyn_mass.h" 

2 . 5 . 7 . 1 . 1  dynamics_calc_inertiaI_forces 

This  routine  calculates  gyroscopic  torques  and  centrifugal  forces  according  to  the  following 
algorithm; 

T  =  -wxIw  =  (Iw)  X  w 
R  =  -M  (wxv)=M  (vxw) 

Parameters  are  represented  as  follows: 
massP  -  mass  properties  structure 

w  -  angular  velocities 

V  --  velocities 

T  ~  resultant  torque 

R  -  resultant  force 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

massP 

pointer  to  MASS_PROP 

/simnet/release/src/libsrc/inclu 
de/dvn  mass.h 

w 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvoes.h 

V 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

T 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

R 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

Angular_momenturm 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

1  Calls  1 

Function 

Where  Described 

mat  vec  mul 

Section  2.6.2.35.1 

Table  2.5>173:  dynamics_calc_inertial_forces  Information. 
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2.S.7.2  calc  u.c 

(/siinnet/telease/src/vehicl^ibsic/libdyn/calc_u.c) 

Includes: 

"sim_types.h" 

"sim_<tfns.h" 

2. 5. 7. 2.1  dynainics_calc_u 

This  routine  integrates  udot  (an  acceleration)  to  get  u  (a  velocity).  This  routine  is  used  to 
update  the  velocity  given  a  previous  velocity  vector,  a  previous  angular  acceleration,  and  a 
jmvious  linear  acceleration.  Parameters  are  represent^  as  follows: 
a^ha  —  angular  acceleration 

a  -  acceleration 

w  “  angular  velocity 

V  —  velocity 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvnedef  Declared 

alpha 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

a 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

w 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

v 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

Table  2.5>174:  dynamics_calc_u  Information. 
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2.5.7 


.3  calc  udot.c 

^siinnet/reIease/src/vehicle/libsrc/libdyn/calc_udot.c) 


Includes: 

"sim_types,h" 

"sim_<tfns.h” 

"dyn_mass.h" 

"Ubmatrix.h" 

2. 5. 7. 3.1  dynainics_calc_udot 

This  routine  calculates  the  new  linear  and  angular  accelerations  given  the  torque  and  force 
applied  to  a  mass  according  to  the  following  algorithms: 
alpha  =1'^ 
a=R/m 

Parameters  are  represented  as  follows: 
massP  -  mass  properites  structure 

T  --  gener^iz^  active  torques 

R  -  generalized  active  forces 

cdpha  -  angular  acceleration 

a  -  acceleration 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

massP 

pointer  to  MASS_PROP 

/simnet/release/src/libsrc/inclu 

de/dyn_mass.h 

T 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

R 

VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

alpha 

pointer  to  REAL 

/simnet/comnfx>n/include/glob 
al/sim  types.h 

a 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

1  Calls  1 

Function 

Where  Described 

mat  vec  mul 

Section  2.6.2.35.1 

vec  scale 

Section  2.6.2.64.1 

Table  2.5-175:  dynamics_calc_udot  Information. 
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2.5.7.4  filter.c 

(/simnetAelease/src/vehicleAibsic/libdyn/filter.c) 

Includes: 

"stdio.h" 

"sys/types.h"  (MASSCX)MP  only) 

”math.h" 

"sim_dfns.h" 

"sim_macn)s.h'' 

"sinutypes.h" 

”dynlib.h" 

2. 5. 7. 4.1  dynamics_fllter_init 

This  routine  allocates  memory  for  a  filter,  setting  a  pointer  to  the  filter. 


1  Return  Values  I 

Return  Value 

Type 

Meanina 

loc  filter 

pointer  to  FILTER 

a  pointer  to  the  allocated  filter 

Table  2.5>176:  dynamics_filter_init  Information. 
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2.5.7.4.2 


dynamics_filter_open 


This  routine  builds  a  second  order  filter,  initializes  values,  and  returns  a  pointer  to  the  filter 
instance. 


Parameters  are  represented  as  follows: 
filterP  -  the  filter  structure  pointer 

uta  —  the  damping  ratio 

wn  --  the  natural  frequency  (rads/sec) 

limit  -  the  maximum  change  from  input  (negative  if  there  is  none) 

tiniinc  -  the  time  increment 

init  -  the  initial  value  of  the  filter 


Variables  are  represented  as  follows: 
a  and  b  --  are  of  the  form  l/(  (s+a)^  +  b^) 
r  -  radius  on  Z-plane 

theta  -  angle  on  Z-plane 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

filterP 

pointer  to  FILTER 

/simnet/release/src/iibsrc/inclu 

de/dvniib.h 

zeta 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

wn 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

limit 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

timinc 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

init 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

a 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

b 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

r 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

theta 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

Table  2.5-177:  dynamIcs_filter_open  Information. 
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2. 5. 7. 4. 3  dynaniics_filter_update 

Given  an  input  value,  this  routine  updates  the  filter  and  returns  an  output  value. 


Parameters  are  represented  as  follows: 
fP  -  the  filter  pointer 

in  ~  the  input  value 

iriZ  ~  the  second  input  (for  forces) 


The  variable  out  represents  the  output  at  the  current  time  step. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

fP 

pointer  to  register  FiLTER 

/simnet/release/src/iibsrc/inclu 

de/dvniib.h 

in 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

in2 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  internal  Variables  I 

Variable 

Where  Typedef  Declared 

out 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Return  Values  I 

Return  Value 

Meaning 

out 

REAL 

the  output  at  the  current  time 
step 

Table  2.5*178:  dynamics_filter_update  Information. 
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2. 5. 7. 5  init.c 

(/simnetAclease/srcVvehicle/libsrc/libdyn^t.c) 

Includes: 

"siin_types.h" 

"sim_ctfns.h" 

"dyn_inass" 

Procedure  Declarations: 
duinp_inass() 

2. S. 7. 5.1  dynamicsjnit 

This  routine  initializes  the  mass  properties  matrix  for  body  B. 

Parameters  are  represented  as  follows: 
massP  "  mass  properties  structure 

Mass  -  mass  of  body  B 

/  “  Inertia  matrix  of  B  about  its  center  of  mass 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

massP 

pointer  to  MASS_PROP 

/simnet/release/src'libsrc/inclu 
de/dyn  mass.h 

Mass 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

1 

T_MATRIX 

/simnet/common/include/glob 
al/sim  types.h 

Calls 

Function 

Where  Described 

mat  copy 

Section  2.6.2.39.1 

mat  inverse 

Section  2.6.2.45.1 

Table  2.5-179:  dynamicsjnit  Information. 
2. 5. 7. 5. 2  dump_mass 

This  routine  is  used  for  setting  certain  printouts  during  debugging. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

massP 

pointer  to  MASS_PROP 

/simnet/release/src/libsrc/inclu 
de/dyn  mass.h 

Calls 

Function 

Where  Described 

mat  dump 

Section  2.6.2.41.1 

Table  2.5-180:  dump_mass  Information. 
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2. 5. 7. 6  lag.c 

(/simnet^lease/src/vehicle/libsrc/Iibdyn/lag.c) 

Includes: 

"sim_types.h" 

"sim_dfns.h" 


2. 5. 7. 6.1  first_order_lag 

This  routine  calculates  a  first  order  lag  in  Oder  to  update  the  vehicle  position. 

Parameters  are  represented  as  follows: 
present _x  --  the  present  value 

targetjc  -  the  target  value 

time_constant  -  the  time  constant  to  the  system 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

present_x 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

target_x 

REAL 

/simnet/common/include/glob 
al/sim  tvoes.h 

time_constant 

REAL 

/simnet/common/include/glob 
al/sim types.h 

1  Return  Values  I 

Return  Value 

Meanina 

present  x 

REAL 

the  present  value 

Table  2.5<181:  first_order_lag  Information. 
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2.5.8  libkin 

(/simnetAelease/src/vehicle/libsrc/libkin  [libkin]) 

This  library  maintains  the  kinematic  state  of  the  Ml  and  M2  from  update  data  provided  by 
vehicle  specific  code.  There  routines  are  usedto  move  the  vehicle  forward,  turn  the  vehicle, 
calculate  the  direction  cosine  matrix  of  the  vehicle,  provide  the  square  of  the  range  from 
another  point  to  the  vehicle,  and  it  provides  access  routines  for  all  the  internal  kinematics 
information.  It  uses  the  unit  normd  vector  for  the  terrain  patch  the  vehicle  is  on,  as 
provided  by  the  libbigwheel  library. 


2.5.8. 1  hull  info.c 

(/simnet/reI^e/src/vehicle/libsrc/libkin/hull_info.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"kinjoc.h" 


2.5.8. 1.1  kinematics_get_w_to_h 

This  routine  returns  the  world  to  hull  transformation  matrix,  outjdnemat  is  a  global 
variable  which  is  used  to  access  the  HULLJNFO  structure  from  outside  the  kinematics 
library.  It  is  passed  into  this  routine  as  the  primary  parameter  and  is  a  pointer  to  an  int. 
Within  this  routine,  out  kinemat  is  cast  as  a  pointer  into  the  HULL_INFO  structure.  This 
allows  tile  i-iformation  in  the  HULL_INFO  structure  to  be  insulated  from  the  rest  of  the 
simulation. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

out  kinemat 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

NULL 

T_MAT_PTR 

null  pointer 

({(HULL_INFO*)out_kinemat)- 
>worid  to  hull) 

T_MAT_PTR 

the  world  to  hull  transformation 
matrix 

Table  2.5-182:  kinematics_get_w_to_h  Information. 
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2. 5. 8. 1.2  kinematlcs_get_h_to_w 


This  routine  returns  the  hull  to  world  transfoimation  matrix,  out  jdnemat  is  a  global 
variable  which  is  used  to  access  the  HULLJNFO  structure  from  outside  the  kuiematics 
library.  It  is  passed  into  this  routine  as  the  primary  parameter  and  is  a  pointer  to  an  int. 
Within  this  routine,  outjdnemat  is  cast  as  a  pointer  into  the  HlJLL_INFO  structure.  This 
allows  the  information  in  the  HlJLL_INFO  structure  to  be  insulated  from  the  rest  of  the 
simulation. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

out  kinemat 

tiointer  to  int 

Standard 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

NULL 

T_MAT_PTR 

null  pointer 

{{(HULLJNFO*)out_kinemat)- 
>hull.  to  world) 

T  MAT  PTR 

the  hull  to  world  transformation 
matrix 

Table  2.5-183;  kinematics_get_h_to_w  Information. 


2.5.8. 1.3  klnematics_get_h_to_o 

This  routine  returns  the  hull  to  origin  vector,  outjdnemat  is  a  global  variable  which  is 
used  to  access  the  HULLJNFO  structure  from  outside  the  kinematics  library.  It  is  passed 
into  this  routine  as  the  primary  parameter  and  is  a  pointer  to  an  int.  Within  this  routine, 
outjdnemat  is  cast  as  a  pointer  into  the  HULL_INFO  structure.  This  allows  the 
informadon  in  the  HULL  INFO  structure  to  be  insulated  from  the  rest  of  the  simulation. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

out  kinemat 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  REAL 

null  pointer 

(((HULLJNFO*)out_kinemat)- 
>hull  to  origin) 

pointer  to  REAL 

hull  to  origin  vector 

Table  2.5-184: 


kmematics_get_h_to_o  Information. 
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2. 5. 8.1.4 


kineinatics_get_o_to_h 


This  routine  returns  the  origin  to  hull  vector,  out  kinemat  is  a  global  variable  which  is 
used  to  access  the  HULL_INFO  structure  from  outside  the  kinematics  library.  It  is  passed 
into  this  routine  as  the  primary  parameter  and  is  a  pointer  to  an  int.  Within  this  routine, 
outjdnemat  is  cast  as  a  pointer  into  the  HULL_INFO  structure.  This  allows  the 
information  in  the  HlJLL_INFO  structure  to  be  insulated  from  the  rest  of  the  simulation. 


1  Parameters  I 

1  Parameter 

Where  Typedef  Declared 

lout  kinemat 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

NULL 

pointer  to  REAL 

null  pointer 

(((HULLJNFO*)out_kinemat)- 
>origin  to  hull) 

pointer  to  REAL 

origin  to  hull  vector 

Table  2.5-185:  kinematics_get_o_to_h  Information. 


2.5.8. 1.5  kinematics_get_u_norm 

This  routine  returns  the  unit  normal  through  the  support  plane,  out  kinemat  is  a  global 
variable  which  is  used  to  access  the  HULLJNFO  structure  from  outside  the  kinematics 
library.  It  is  passed  into  this  routine  as  the  primary  parameter  and  is  a  pointer  to  an  int. 
Witiiin  this  routine,  out  kinemat  is  cast  as  a  pointer  into  the  HULL_INFO  structure.  This 
allows  the  information  in  the  HlJLL_INFO  structure  to  be  insulated  from  the  rest  of  the 
simulation. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

out  kinemat 

pointer  to  int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  REAL 

null  pointer 

(((HULLJNFO*)out_kinemat)- 
>unit  normal) 

pointer  to  REAL 

the  unit  normal  vector  through 
the  support  plane 

Table  2.5-186:  kinematics_get_unit_normal  Information. 
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2 .5 .8 . 1 .6  kinematics_get_veIocity 

This  routine  returns  the  vehicle  velocity  in  world  coordinates  in  meters  per  second. 
outjdnemat  is  a  global  variable  which  is  used  to  access  the  HULI>_INFO  structure  from 
outside  the  kinematics  libra^.  It  is  passed  into  this  routine  as  the  primary  parameter  and  is 
a  pointer  to  an  int  Within  tiiis  routine,  outjdnemat  is  cast  as  a  pointer  into  the 
HULL_INFO  structure.  This  allows  the  information  in  the  HULL_INFO  structure  to  be 
insulated  from  the  rest  of  the  simulation. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

out  kinemat 

pointer  to  int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

loc  kinemat 

pointer  to  HULL  INFO 

kin  loc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  REAL 

null  pointer 

veh_veloc 

pointer  to  REAL 

velocity  of  the  vehicle 

Table  2.5«187:  kinemaiics_get_velocity  Information. 


2.5.8. 1.7  kinematics_get_d_pos 


This  routine  returns  the  change  in  position  in  world  coordinates  per  DELTA_T. 
out  kinemat  is  a  global  variable  which  is  used  to  access  the  HIJLL_1NF0  structure  from 
outside  the  kinematics  library.  It  is  passed  into  this  routine  as  the  primary  parameter  and  is 
a  pointer  to  an  int.  Within  this  routine,  out  jdnemat  is  cast  as  a  pointer  into  the 
lRJLL_INFO  structure.  This  allows  the  information  in  the  HULL_INFO  structure  to  be 
insulated  from  the  rest  of  the  simulation. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

out  kinemat 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  REAL 

null  pointer 

(((HULLJNFO*)out_kinemat)- 
>delta  position) 

pointer  to  REAL 

change  in  position  in  world 
coordinates 

Table  2.5-188:  kinematics_get_d_pos  Information. 
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2.5.8.1.8 


kineihatics_get_slope_ind 


This  routine  determines  the  hull  direction  and  hull  slope  values,  hidl  dir  represents  the 
ange  which  characterizes  the  orientation  of  the  hull  in  radians,  cos  hull _slope  represents 
the  cosine  of  the  angle  ftom  straight  up.  out  kinemat  is  a  global  variable  which  is  used  to 
access  the  HULL_WFO  structure  ftom  outside  the  kinematics  library.  It  is  passed  into  this 
routine  as  the  prim^  parameter  and  is  a  pointer  to  an  int.  Within  this  routine,  out  kinemat 
is  cast  as  a  pointer  into  the  HULL_INFO  structure.  This  allows  the  information  in  the 
HULL_INFO  structure  to  be  insulated  ftom  the  rest  of  the  simulation. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

out  kinemat 

pointer  to  int 

Standard 

hull_dir 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

cos_hull_slope 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

loc  kin 

pointer  to  HULL  INFO 

kin  loc.h 

u_norm 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

temp_hull_dir 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

I  Calls  1 

Function 

Where  Described 

eq 

Macro  defined  in 

/simnet/common/include/Qlobal/sim  macros.h 

Table  2.5-189:  kinematics_get_slope_ind  Information. 


1107 


BBN  Systems  anifi  Technologies 


Vehicles  CSQ 


2^JB.3  lEUB_init.c 

(/sunnetfselease/sic/vehicle/libsTc/libkin/kin.initc) 

biduides: 

’’stdio.hr’ 

”math.h"’ 

"sim_typies.h" 

’’sim_(fi&ffi.h" 

"sim_macros.h” 

"kinjocih" 

’’Ubkin.h’” 

’•libbigwocLh” 

2. 5. 8. 3.1  ftiaematics_uninit 

This  routine  rotstthe  locations  to  zero  when  the  simulator  is  deactivated.  This  is  used  as  a 
debugging  tool  loutjdnemat  is  a  global  variable  which  is  used  to  access  the  HULL_INFO 
structture  from  oiutside  the  Idneniatics  libraiy.  It  is  passed  into  this  routine  as  the  primary 
parameter  and  isai  pointer  to  an  int  Within  this  routine,  out  jcinemat  is  cast  as  a  pointer 
into  the  HULLJONTO  structure.  This  allows  the  information  in  the  HULL_INFO  structure 
to  be  ansdated  frcsm  the  rest  of  the  simulation. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Typedef  Declared 

out  kdnemat 

pointer  to  int 

Standard 

Calls 

Function 

Where  Described 

kinemeatics  pos  imit 

Section  2.5.8.13.1 

Table  2.5*190:  kinematics  uninit  Information. 
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2. 5. 8. 3. 2  kinematics_init 

This  routine  initializes  the  work  space  and  fills  in  the  initial  parameters.  Memory  is 
allocated  and  a  pointer  to  char  is  returned.  That  pointer  is  cast  at  a  pointer  to  the 
HULL_INFO  structure.  The  pointers  are  allocated  and  filled  in.  veh_kin  is  cast  as  a 
pointer  to  an  int  in  order  to  insulate  the  HULL_INFO  structure  from  the  world  outside  the 
kinematics  library. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

veh  kin 

pointer  to  pointer  to  int 

Standard 

veh  biowh 

pointer  to  pointer  to  int 

Standard 

veh  SUSP 

pointer  to  pointer  to  int 

Standard 

veh  terr 

pointer  to  pointer  to  int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

loc  kinemat 

pointer  to  HULL  INFO 

kin  loc.h 

1  Calls  1 

Function 

Where  Described 

biowheel  init 

Section  2.5.10.1.2 

kinematics  uninit 

Section2. 5.8.3. 1 

Table  2.5-191:  kinematicsjnit  Information. 
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2. 5. 8.4  kin  loc.c 

(/Emi!metAdease/srcArelucle/libsrc/libldn/kin_loc.c) 

This  file  OQBitains  stuff 

Includes: 

"8ldao.h" 

*'iiiatdi.h'' 

"sin»_types.h" 

"siin_dfns.h" 

"sinR_macros.h" 


Defines: 

MAX_U_N_CHANGE 

MAX_VELOC_CHANGE 

MAX_HEADING_CHANGE 

Declared: 

RVA_U_NORM_CHECK 

RVA_VELOC_CHECK 

RVA_HEADING_CHECK 


2. 5. 8. 5  kin  loc.h 

(/simnetA’Bease/srcA'ehkle/libsrc/libkin/kin.loc.h) 

The  followk:^  functions  are  declared: 

kineE3iatics_set_local_kineniatics  () 
ldnegTiatics_vehicle_initO 

The  following  constants  are  declared: 

RVA_U_NORM_CHECK; 

RVA_VELOC_CHECK; 

RVA_HEADING_CHECK; 

The  kineniatics_info  structure  is  declared.  The  HULL_INFO  stucture  is  instantiated. 


2. 5. 8. 6  kin_siniul.c 

(/simnet/reiease/src/vehicle/Iibsrc/libkin/kin.simul.c) 

This  file  con^tains  the  primary  kinematics  simulaiton  routine. 

Includes: 

"stdkr.h" 

"matih.h" 

"siin_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"kin  loc.h" 

"libkdn.h" 

"bigwhcel.h" 

"libterrain.h" 
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2. 5. 8. 6.1  kinematics_siinul 

Kinematics  simuIO  is  the  routine  called  every  tick  to  perform  various  kinematics 
functions  (kinematics  set_locaI_kinematics()).  If  kinematics  has  been  initialized, 
then  everyAing  proceeds  asliormal.  However,  kinematics  cannot  be  initialized  until  a  valid 
patch  of  local  terrain  has  been  received.  If  kinematics  has  yet  to  be  initialized,  then  a  check 
is  made  to  see  if  a  terrain  patch  has  been  received  recently.  If  so,  then  an  attempt  is  made  to 
initialize  kinematics.  However,  if  there  is  a  problem  with  the  terrain  patch  (incomplete 
coverage,etc.)  then  bigwheeljnit_support^plane()  will  be  unable  to  provide  a  valid 
unit  nonnal,  and  kinematics  remains  uninidaliz^  >^^en  the  next  terrain  patch  is  received, 
it  tries  again.  After  three  unsuccessful  tries,  a  panic  message  will  be  print^.  outjcinemat 
is  a  global  variable  which  is  used  to  access  the  HlJLL_INFO  structure  from  outside  the 
kinematics  library.  It  is  passed  into  this  routine  as  the  prim^  parameter  and  is  a  pointer  to 
an  int.  Within  this  routine,  out  jcinemat  is  cast  as  a  pointer  into  the  HULL_INFO 
structure.  This  allows  the  information  in  the  HlJLL_INFO  structure  to  be  insulated  from 
the  rest  of  the  simulation. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

out  kinemat 

pointer  to  int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

loc  kin 

pointer  to  HULL  INFO 

kin  loc.h 

1  Calls  1 

Function 

Where  Described 

kinematics_set_locaLkinemati 

cs 

Section  2.5.8.9.1 

terrain  It  inited 

Section  2.5.11.4.1 

biqwheel  init  support  plane 

Section  2.5.10.7.1 

kinematics  vehicle  init 

Section  2.5.8.13.2 

terrain  uninit 

Section  2.5.11.7 

Table  2.5-192:  kinematics  simul  Information. 
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2. 5. 8. 7  BBOve_veh.c 

(/'simnetAel^e^srcA^ehicle/libsrc/libkin/move_veh.c) 

This  file  contaiins  a  routine  which  moves  the  vehicle  forward  by  the  indicated  increment 

Includes: 

"stdio.te" 

”math.fti” 

"simjy'pes.h" 

"sim_®ns.h" 

"sim_iiaacros.h” 

"kinjaic.h" 

"Ubkin.lh" 

"bigwtesel.h" 

"Ubmaiffix.h" 
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2.5.8  7.1 


kinematics  move  vehicle 


This  routine  moves  a  vehicle  forward  by  the  indicated  increment,  inc.  Check  first  to  see  if 
the  vehicle  can  move.  Move  the  vehicle  along  the  Y  axis  in  its  own  hull  coordinates  by  the 
negation  of  the  increment.  Update  the  values  in  o_to_h  and  d _pos. 


outjdnemat  is  a  global  variable  which  is  used  to  access  the  HULL_INFO  structure  from 
outside  the  kinematics  library.  It  is  passed  into  this  routine  as  the  primary  parameter  and  is 
a  pointer  to  an  int  Within  this  routine,  outjdnemat  is  cast  as  a  pointer  into  the 
lrtJLL_INFO  structure.  This  allows  the  information  in  the  HULL_DJFO  structure  to  be 
insulated  from  the  rest  of  the  simulation. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

out  kinemat 

pointer  ot  int 

Standard 

inc 

register  REAL  ^ 

/simnet/common/include/glob 
al/sim  types. h 

1  Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

loc  kin 

pointer  to  HULL  INFO 

kin  loc.h 

o_to_h 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim_  types. h 

h_to_o 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  types. h 

dj30S 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  types.h 

h_to_w 

pointer  to  register 

T  MAT  PTR 

/simnet/common/include/glob 
al/sim  types.h 

1  Calls  1 

Function 

Where  Described 

eq 

Macro  defined  in 

/simnet/common/include/qlobal/sim  macros. h 

vec_mat_mul 

Section  2.6.2.56.1 

vec  scale 

Section  2.6.2,64.1 

vec  init 

Section  2.6.2.61.1 

Table  2.5>193:  kinematics  move  vehicle  Information. 
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2. 5. 8. 8  p_c  sincss.c 

(/sininet^eaasfrfircA'ehicle/libsrc/libkin/p_c_sines.c) 

This  file  contains  loufimss  which  return  the  sime  and  cosine  for  the  hull's  pitch  and  cant. 

Includes: 

"stdio.h" 

"siin_types.h" 

"sim_(MisJi’' 

"sim_macrosJi^ 

•’kin_loc.h" 


Defines: 

CANT.SIN 

PITCH.SIN 

PITCH_CX)S 

CANT_COS 


2. 5. 8. 5.1  kineD]iltics_cant_cos 

This  routine  returns  thec&osine  of  the  angle  at  which  the  hull  is  canted,  out  jdnemat  is  a 
global  variable  which  femsed  to  access  Ae  HULL_INFO  structure  from  outside  the 
kinematics  library.  It  oifpassed  into  this  routine  as  the  primary  parameter  and  is  a  pointer  to 
an  int.  Within  this  routinie,  outjdnemat  is  cast  as  a  pointer  into  the  HULL_INFO 
structure.  This  allows  due  information  in  the  HULL_INFO  structure  to  be  insulated  from 
the  rest  of  the  simulatiom. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

out  kinemat 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

0.0 

REAL 

no  data  available 

(((HULL  INFO)  out  kinemKat)- 
>CANT  COS) 

REAL 

cosine  of  angle  of  cant 

Table  3£.5-194; 


kinematics  cant  cos  Information. 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2. 5. 8. 5. 2  kineinatics_pitch_cos 

This  routine  returns  the  cosine  of  the  angle  at  which  the  hull  is  pitched,  out  kinemat  is  a 
global  variable  which  is  used  to  access  &e  HlJLL_INFO  structure  from  outside  the 
kinematics  library.  It  is  passed  into  this  routine  as  the  primary  parameter  and  is  a  pointer  to 
an  int.  Within  this  routine,  out  kinemat  is  cast  as  a  pointer  into  the  HULL_INFO 
structure.  This  allows  the  information  in  the  HULL_INFO  structure  to  be  insulated  from 
the  test  of  the  simulation. 


1  Parameters  I 

1  Parameter 

Where  Tvpedef  Declared 

1  out.kinemat 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0.0 

REAL 

no  data  available 

(((HULL  INFO*)  out  kinemat)- 
>PITCH  COS) 

REAL 

cosine  of  angle  of  pitch 

Table  2.5-195:  kinematics_pitch_cos  Information. 


2. 5. 8. 5. 3  kinematics_cant_sin 

This  routine  returns  the  sine  of  the  angle  at  which  the  hull  is  canted,  outjcinemat  is  a 
global  variable  which  is  used  to  access  the  HULL_INFO  structure  from  outside  the 
kinematics  library.  It  is  passed  into  this  routine  as  the  prim^  parameter  and  is  a  pointer  to 
an  int.  Within  this  routine,  outjcinemat  is  cas*  a  pointer  into  the  HlJLL_INFO 

structure.  This  allows  the  information  in  the  H  .^L_INFO  structure  to  be  insulated  from 
the  rest  of  the  simulation. 


1  Parameters  I 

1  Parameter 

Where  Typedef  Declared 

lout kinemat 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0.0 

REAL 

no  data  available 

(((HULL  INFO*)  out  kinemat)- 
>CANT  SIN) 

REAL 

sine  of  cant  angle 

Table  2.5-196:  kinematics  cant  sin  Information. 
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2.5J8.5.1  kinematics_pitch_sin 

ThisTOutine  renuns  the  sine  of  the  angle  at  which  the  hull  is  pitched,  outjdnemat  is  a 
globaal  variable  which  is  used  to  access  the  HULL_INFO  structure  from  outside  the 
kinemiatics  library.  It  is  passed  into  this  routine  as  the  primary  parameter  and  is  a  pointer  to 
an  iffiL  Within  this  routine,  out  kinemat  is  cast  as  a  pointer  into  the  HULL_INFO 
structure.  This  allows  the  information  in  the  HULL_INFO  structure  to  be  insulated  from 
the  rest  of  the  simulation. 


1  Parameters  I 

Paraumeter 

Where  Tvpedef  Declared 

out  k^emat 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0.0 

REAL 

no  data  available 

(((HU^L  INFO*)  out  kinemat)- 
>PITCH  SIN) 

REAL 

sine  of  pitch  angle 

Table  2.5-197:  kineinatics_pitch_sin  Information. 


2.5.B.9  set_loc_kin.c 

(/simnet/rclease/src/vehicle/libsrc/libldn/set_loc_kin.c) 

Incloides: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_raacros.h" 

"kin_loc.h" 

"libkin.h" 

"bigwheel.h" 

’’libmatrix.h" 

"libterrain.h" 

Declared: 

get_orient_vecs() 

kinematics~fix_matrix() 
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2 . 5 . 8 . 9 . 1  kinematics_set_local_kineinatics 

This  routine  computes  the  transfoim  matrix  from  the  previous  hull  matrix  and  the  new  unit 
normal  for  the  local  tank.  If  the  unit  normal  has  not  changed  since  the  last  tick  (which 
would  happen  if  the  vehicle  was  stopped  and  stable,  or  moving  on  flat  ground  and  stable), 
then  local_kinematics  is  not  run.  This  routine  is  called  at  least  twice  a  second  to  ensure  that 
the  vehicle  does  not  drift  underground  while  traveling  on  a  level  surface  when  the  vehicle 
itself  is  not  level. 


Parameter 


loc  kin 


Parameters 


inter  to  HULL  INFO 


Where  Tyoedef  Declared 


kin  loc.h 


Internal  Variables 


Internal  Variable 


d_orient_mat 


temp_matnx 


w  to  h 


abs  b 


sqrjemp 


denom 


new_height 


h  to  0 


u  norm 


force  local  kin 


T  MATRIX 


register  T_MAT_PTR 


register  T_MAT_PTR 


register  REAL 


register  REAL 


register  REAL 


register  REAL 


register  REAL 


register  REAL 


register  REAL 


register  REAL 


register  REAL 


register  REAL 


pointer  to  register  REAL 


pointer  to  register  REAL 


VECTOR 


VECTOR 


VECTOR 


Static  int 


Where  Tvpedef  Declared 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/giob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


Standard 


1117 


BBN  Systems  and  Technologies _ Vehicles  CSCI 


1  Calls  1 

Function 

Where  Described 

biowheel  set  support  plane 

Section  2.5.10.8.1 

vec  dot  prod 

Section  2.6.2.54.1 

pet  orient  vecs 

Section  2.5.8.9.3 

max 

Macro  defined  in 

/simnet/common/include/qlobal/sim  macros. h 

eq 

Macro  defined  in 

/simnet/common/include/Qtobal/sim  macros. h 

square 

Macro  defined  in 

/simnet/common/include/Qlobal/sim  macros. h 

mat  mat  mul 

Section  2.6.2.32.1 

mat  transpose 

Section  2.6.2.52.1 

terrain  calc  elev 

Section  2.5.11.1.1 

kinematics  fix  matrix 

Section  2.5.8.9.2 

vec_mat  mul 

Section  2.6.2.56.1 

Table  2.5-198:  kineinatics_set_local_kinematics  Information. 


2. 5. 8. 9. 2  kinematics_fix_matrix 

This  routine  fixes  a  world  to  hull  matrix  (wjoji),  its  transverse  {hjo_w\  and  hull  to 
ori^  (h  to  o)  vector  to  prevent  disasters.  It  also  fixes  the  origin_to_hull  (o-to  ji)  vector. 
This  roudnels  called  to  reorthonormalize  the  matrices. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

w_to_h 

register  T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

h_to_w 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

h_to_o 

register  VECTOR 

/simnet/common/include/glob 

al/simjypes.h 

o_to_h 

VECTOR 

/simnet/common/include/glob 
al/sim  types. h 

1  Calls 

Function 

Where  Described 

mat  fix  matrix 

Section  2.6.2.30.1 

mat  transpose 

Section  2.6.2.51.1 

vec  mat  mul 

Section  2.6.2.56.1 

Table  2.5-199:  kinematics_f1x_matrix  Information. 
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2. 5. 8. 9. 3  get_onent_vecs 

This  routine  gets  the  orientation  vectors. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

loc  kin 

pointer  to  HULL  INFO 

kin  loc.h 

u_ptr 

register  VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

v_ptr 

register  VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

wjatr 

register  VECTOR 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

l_real 

register  pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

Table  2.5*200:  get_orient_vecs  Information. 


2.5.8.10  sqr_range.c 

(/simne^release7src/vehicle/libsrc/libkin/sqr_range.c) 

This  file  contains  a  routine  which  computes  the  square  of  the  range  between  a  point  and  the 
vehicle. 

Includes: 

"stdio,h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"kinjoc.h" 

"libkin.h" 

"libmatrix.h" 
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2.5.8. 10. 1  kinematics_range_squared 

Hiis  routine  computes  the  square  of  the  range  between  the  last  position  and  the  current 
pasidon  in  three  directions.  This  routine  is  called  from  "librva".  outjdnemat  is  a  global 
atariable  which  is  used  to  access  the  HULLJNFO  structure  from  outside  the  kinematics 
%rary.  It  is  passed  into  this  routine  as  the  prin^  parameter  and  is  a  pointer  to  an  int 
Withm  this  routine,  outjcinemat  is  cast  as  a  pointer  into  the  HULL_INFO  structure.  This 
t^ows  the  information  in  the  HULL_INFO  structure  to  be  insulated  from  the  rest  of  the 
aunulation. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

omt  kinemat 

pointer  to  int 

Standard 

_ 

pointer  to  reaister  double 

Standard 

Internal  Variables 

Ireternal  Variable 

Where  Typedef  Declared 

oShp 

reqister  pointer  to  double 

Standard 

delta  X 

reqister  double 

Standard 

deha  V 

reqister  double 

Standard 

deha  z 

reqister  double 

Standard 

1  Return  Values  1 

Rteturn  Value 

Type 

Meaning 

OiO 

REAL 

no  data  available 

(fdelta_x*delta_x)+(delta_y*d 

elha  v)*(delta  z*delta  z)) 

REAL 

the  square  of  the  range 
between  two  points 

Table  2.5*201:  kinematics_range_squared  Information. 


2.5.8.11  turn_veh.c 

(/simnet/release/src/vehicle/libsrc/libkin/tum_veh.c) 

Tliis  file  contains  a  routine  which  turns  the  vehicle  in  its  local  coordinate  system. 

fincludes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dtfns.h" 

"sim_macros.h'' 

"kinjoc.h" 

"libkin.h" 

"libmatrix.h" 
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2.5.8.11.1  kinematics_turn_vehicle 

This  routine  turns  the  vehicle  in  its  local  coordinate  system.  Since  the  vehicle  turns  less 
than  0.1  radians  per  DELTA_T  seconds,  the  approximation  x=sin(x)  is  used,  angle  is  the 
turn  angle.  A  turn  to  the  left  is  denoted  as  a  positive  angle,  and  a  turn  to  the  right  is 
denoted  as  a  negative  angle,  out  idnemat  is  a  global  variable  which  is  used  to  access  the 
HULL_INFO  structure  from  outside  the  kinematics  library.  It  is  passed  into  this  routine  as 
the  primary  paran^ter  and  is  a  pointer  to  an  int.  Within  this  routine,  out  kinemat  is  cast  as 
a  pointer  into  the  HULLJNFO  structure.  This  allows  the  information  in  the  HULL_INFO 
structure  to  be  insulated  from  the  rest  of  the  simulation. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

out  kinemat 

pointer  to  int 

Standard 

angle 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

loc  kin 

pointer  to  HULL  INFO 

kin  loc.h 

rot_matrix 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

r_mat 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

oJo_h 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

h_lo_o 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

w_to_h 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

h_to_w 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

mat  rot  init2 

Section  2.6.2.33.1 

mat  mat  mul 

Section  2.6.2.32.1 

mat  transpose 

Section  2.6.2.51.1 

vec  mat  mul 

Section  2.6.2.56.1 

Table  2.5-202:  kinematics_turn_vehicle  Information. 
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2.5.8.12  update.c 

(/simnetAelease/sic/vehicle/libsrc/libkin/update.c) 


Includes: 

''stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sun_inacros.h 

"kin_loc.h" 


II 


"Ubkin.h" 

"libmatrix.h" 


2.5.8.12.1  kinematics_update_rva 

This  routine  is  used  to  save  local  kinematics  data,  out  jdnemat  is  a  global  variable  which  is 
used  to  access  the  HULL_INFO  structure  from  outside  the  kinematics  library.  It  is  passed 
into  this  routine  as  the  primary  parameter  and  is  a  pointer  to  an  int.  Within  this  routine, 
outjdnemat  is  cast  as  a  pointer  into  the  HULL_d4F0  structure.  This  allows  the 
information  in  the  HULL_INFO  structure  to  be  insulated  from  the  rest  of  the  simulation. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

out  kinemat 

pointer  to  int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Tvoedef  Declared 

loc  kin 

pointer  to  HULL  INFO 

kin  loc.h 

1  Calls  1 

Function 

Where  Described 

vec  copy 

Section  2.6.2.59.1 

Table  2.5>203:  kinematics_update_rva  Information. 


2.5.8.13  veh  init.c 

(/simnet/r^ease/src/vehicle/libsrc/libkin/veh_iniLc) 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"kin_loc.h" 

"Ubkin.h" 

"Ubmatrix.h" 

"bigwheel.h" 

"Ubterrain.h" 
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2.5.8.13.1 


kineinatics_pos_init 


This  routine  is  called  when  the  vehicle  is  initialized.  The  initial  position  and  heading  of  the 
tank  (x,  y,  and  yaw)  are  passed  in.  If  x  and  y  are  divisible  by  125, 0.5  is  added  to 
eliminate  ambiguity  about  which  terrain  patch  the  vehicle  is  on.  Note  that  the  actual 
initialization  of  the  vehicle  is  not  done  here,  but  in  the  routine 
kinematics_vehicle_inU(). 


outjdmmai  is  a  global  variable  which  is  used  to  access  the  HULL_INFO  structure  from 
outside  the  kinematics  library.  It  is  passed  into  this  routine  as  the  primary  parameter  and  is 
a  pointer  to  an  int  Within  this  routine,  outjdnemat  is  cast  as  a  pointer  into  the 
lrtJLL_INFO  structure.  This  allows  the  information  in  the  HULL_INFO  stracture  to  be 
insulated  from  the  rest  of  the  simulation. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

out  kinemai 

pointer  to  int 

Standard 

X 

register  REAL 

/simnet/common/include/glob 
al/sim  types. h 

y 

register  REAL 

/simnet/common/include/glob 
al/sim  types. h 

yaw 

register  REAL 

/simnet/common/include/glob 
al/sim  types.h 

Internal  Variables 

■  internal  Variable 

Where  Typedef  Declared 

hoc  kin 

pointer  to  HULL  INFO 

kin  loc.h 

1  Calls  1 

Function 

Where  Described 

kinematics  vehicie  init 

Section  2.5.8.13.2 

vec  CODV 

Section  2.6.2.59.1 

Table  2.5*204:  kinematics_pos_init  Information. 
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2.5.8.13.2  kinematics  vehicle  init 


This  routine  initializes  the  transform  matrix,  its  inverse,  its  unit  normal  vector,  and  the 
hull_to_origin  vector  of  a  vehicle,  given  its  desired  x-y  location  and  heading  in  world 
coordinates. 


Parameters  I 

Parameter 

Where  Typedef  Declared 

loc  kin 

pointer  to  HULL  INFO 

kin  loc.h 

X 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

y 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

yaw 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

w_to_h 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

h_to_w 

register  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  tvpes.h 

h_to_o 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

o_to_h 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

u_norm 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

o_mat 

T_MATRIX 

/simnet/common/include/glob 
al/sim  Jvpes.h 

temp_norm 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

tempi 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

temp2 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

temp3 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls 

Function 

Where  Described 

mat  rot  init 

Section  2.6.2.47.1 

terrain  calc  elev 

Section  2.5.11.1.1 

vec  scale 

Section  2.6.2.64.1 

vec  mat  mul 

Section  2.6.2.56.1 

mat  transpose 

Section  2.6.2.51.1 

biawheel  init  support  plane 

Section  2.5.10.7.1 

vec  cross  prod 

Section  2.6.2.66.1 

mat  mat  mul 

Section  2.6.2.32.1 

Table  2.5-205:  kinematics_vehicle_inlt  Information. 
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2.5.9  libhull 

(/simnet^lease/src/vehicle/libsic/libhull  [libhull]) 


This  library  initializes  the  hull  of  a  vehicle  by  allocating  memory  for  the  kinematics,  terrain, 
suspension,  and  bigwheel  state  data.  It  is  cdled  by  main.c  in 
/simnet^leaseA'ehicle/libsrc/libmain. 


2.5.9.1  hulMnit.c 

(/simne^lease/src/vehicle/libsrc/libhull/hull_init.c) 

This  file  contains  routines  which  initialize  and  uninitialize  the  hull  of  a  vehicle. 


Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h 

"Ubkin.h" 


II 


"libsusp.h" 

"UbhulLh" 


"libbigwheel.h" 

"libterrain.h" 


2.5.9. 1.1  hulijnit 

This  routine  initializes  the  hull  of  a  vehicle  by  allocating  memory  for  the  kinematics,  terrain, 
suspension,  and  bigwheel  state  data. 


1  Calls  1 

Function 

Where  Described 

kinematics  init 

Section  2.5.8.3.2 

Table  2.5-206:  hull  init  Information. 


2.5.9. 1.2  hull_uninit 

This  routine  uninitializes  the  hull  of  a  vehicle  by  deallocating  memory  for  the  kinematics, 
terrain,  suspension,  and  bigwheel  state  data. 


1  Calls  1 

Function 

Where  Described 

biowheel  uninit 

Section  2.5.10.1.1 

suspension  uninit 

Section  2.5.6.4.1 

terrain  uninit 

Section  2.5.11.7 

kinematics  uninit 

Section  2. 5.8.3. 1 

Table  2.5-207:  hull  uninit  Information. 
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2.5.9.2  hull  loc.c 

(/simnet7rclease/srcA^ehicle/libsic/libhull/hull_loc,c) 

The  Tc  »wing  pointers  are  declared  and  initialized: 

\  wn_tonematics 
veh_bigwheel 
veh_suspension 
veh_terrain 
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2.5.10  libbigwh 

(/simne^lease/src/vehicle/libsrc/libbigwh  [libbigwh]) 

The  support  plane  of  the  vehicle  is  determined  by  taking  three  points  under  the  tank  (right 
front,  left  front,  and  rear  ~  like  a  backward  child’s  bigwheel)  and  calculating  a  unit  normal 
to  that  plane.  This  library  calculates  this  normal,  and  passes  it  onto  the  kinematics  library. 
The  bigwheel  library  also  registers  collisions  wiA  other  objects  on  the  terrain  and  informs 
the  kinematics  library.  The  M-1  tank  is  modeled  as  the  three  wheels  of  a  child's 
"Bigwheel".  The  thiw  points  of  contact  with  the  terrain  define  a  support  plane  for  the  tank. 
The  unit  normal  of  this  support  plane  is  computed  and  passed  on  to  the  kinematics  code. 

2.5.10.1  bigwh_init.c 

(/simnet/release/src/vehicle/libsrc/libbigwh/bigwh_init.c) 

Includes; 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"bigwhjoc.h" 

"libterrain.h" 

"libsusp.h" 

2.5.10.1.1  bigwheel_uninit 

This  routine  uninitializes  the  bigwheel  data  structure  by  zeroing  out  the  structure  and  setting 
the  number  of  collisions  to  zero. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

out  biQwh 

pointer  to  int 

Standard 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

loc  biQwh 

pointer  to  BIGWHEEL 

Section  2.5.10.2 

1'able  2.5>i08:  bigwheel_uninit  Information. 
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2.5.10^..1.2  bigwheeMnit 

This  romtine  is  called  by  kinematics  initO  to  initialize  the  local  vehicle's  bigwheel 
workspatce.  The  local  data  structure  Is  allocated. 


Parameters  1 

Parameit«r 

Type 

Where  Typedef  Declared 

out  biaw^eel 

pointer  to  pointer  to  int 

Standard 

out  susoi^nsion 

pointer  to  pointer  to  int 

Standard 

out  terrakn 

pointer  to  pointer  to  int 

Standard 

1  Internal  Variables  1 

Variables 

Where  Typedef  Declared 

loc  biawir::^ 

pointer  to  BIGWHEEL 

Section  2.5.10.2 

1  Calls  1 

Functlom 

Where  Described 

suspension  init 

Section  2.5. 6.4.2 

terrain  in»it 

Section  2.5.11.7 

biowheel  uninit 

Section  2.5.10.1.1 

Table  2.5-209:  bigwheeMnit  Information. 

2.5.10..2  bigwh^loc.h 

^?simnet^le^e/src/vehicle/libsrc/libbigwh/bigwhJoc.h) 


Includes 

"bigwheel.h" 


Defines 

BIGWHEEL_DEBUG 


The  folIc?wing  are  declared  as  external: 
laigwheel_calc_unit_normalO; 
CE)llision_detected(); 
ajollision_cleared(); 


The  folkjwing  structure  is  defined: 
BIGWHEEL; 
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2.5.10.3  calc  u_norin.c 

(/siinnet/teleaie/src/vehicle/libsrc/libbigwh/calc_u_norm.c) 

Includes; 

"stdio.h" 

"math.h" 

"sim_(iftis.h" 

"sim_macros.h" 

"sim_types.h" 

"bigwh_loc.h" 

"Ubmatiix.h" 


2.5.10.3.1  bigwheel_calc_unit_normal 

This  routine  calculates  the  unit  normal  vector  of  the  plane  defined  by  three  the  points  of 
support 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

wheels[3] 

register  VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

result 

register  VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

1  internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

Vl 

VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

v2 

VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

v1j3tr 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  tvoes.h 

v2_ptr 

pointer  to  register  REAL 

/simnet/comnK>n/include/glob 
al/sim  tvoes.h 

I  Calls  I 

Function 

Where  Described 

vec  sub 

Section  2.6.2.65.1 

vec  cross  orod 

Section  2.6.2.66.1 

vec  normalize 

Section  2.6.2.63.1 

Table  2.5*210:  bigwheel_calc_unit_normal  Information. 
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2.5.10.4  >«hk  coll.c 

<|Un^th:t?ease/sic/vehicle/libsic/libbigwh/chk_colI.c) 


Includes: 

•W6so.h" 

■■aaLidfns.h" 

”siHo}nacros.h" 

"anc-Jtypes.h" 

-lig»»di_loc-h" 


2.5.10.4.H  collision  left  collision 


This  nxniMd^  called  by  Idneniatics  to  check  to  determine  if  a  collision  has  occuned  on  the 
left  side  of  dlR^e  vehicle. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

out  biowtwet 

pointer  to  int 

Standard 

1  Return  Values  I 

Return  vatu2« 

Meanina 

FALSE 

int 

no  collision  on  left  side 

TRUE 

int 

collision  occurred  on  left  side 

Table  2.5*211:  collisionJeft_collision  Information. 

2.5.10.4.22  collision_right_collision 

This  roudK  ris  called  by  kinematics  to  determine  if  a  collision  has  occuned  on  the  right  side 
of  die  vdsle^. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

out  biawheet 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  VUsise 

Type 

Meaning 

FALSE 

int 

no  collision  on  right  side 

TRUE 

int 

collision  occurred  on  right  side 

Table  2.S-212:  collision_right_collision  Information. 


1130 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.5.10.4.3  col  lisron_rea  r_col  I  ision 

This  routine  is  called  by  kinematics  to  determine  if  a  collision  has  occurred  on  the  rear  of 
the  vehicle. 


1  Parameters  1 

Parameter 

Where  Tvnedef  Declared 

out  biQwheel 

DOinter  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

FALSE 

int 

no  collision  on  rear 

TRUE 

int 

collision  occurred  on  rear 

Table  2.5-213:  collision_rear_coIlision  Information. 

2.5.10.5  coll  init.c 

(/simnet/r^ease/src/vehicle/libsrc/libbigwh/coll_init.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"bigwhjoc.h" 

2.5.10.5.1  collisionjnit 

This  routine  is  called  by  the  vehicle  specific  code  in  order  to  set  up  the  failure  routine  to  be 
called  when  a  collision  occurs.  Currently,  only  the  turret  drive  systems  fail  in  a  collision. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

out  biowheel 

pointer  to  int 

Standard 

failure_rtn 

PFl 

/simnet/common/include/glob 
al/sim  tvpes.h 

Table  2.5-214:  collision  init  Information. 
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2.5.10.6  collision.c 

(/simnel/release/srcA'ehicle/libsrc/libbigwh/collision.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

”dgi_stdg.h" 

"siin_cig_if.h" 

••pn)_sim.h'' 

"obj_type.h" 

"Ubkin.h" 

"Ubrva.h" 

"libevent.h" 

"Ubevent.h" 

"bigwh_loc.h" 

"bigwheeLh" 


Defines: 

COLL_RANGE 

Declarations: 

RANGE.SQRD 
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2.5.10.6.1 


collision  check  veh  coll  at 


This  routine  is  called  by  librva  during  the  tick  by  tick  processing  and  serves  two  purposes: 


1)  When  another  vehicle  is  close,  this  routine  checks  to  see  whether  a  collision  has 
occurred,  or  whether  it  was  just  a  close  miss.  To  check  for  a  collision,  the  distance  (in  the 
x,y  plane)  is  calculated  between  each  of  our  three  bi^heels  and  the  closest  vehicle's  center 
of  mass.  If  the  closest  distance  is  less  than  the  collision  range,  then  a  collision  has 
occurred.  Collisions  may  not  occur  between  vehicles  at  different  heights  (e.g.,  an  airplane 
and  a  truck).  The  routine  also  check  to  make  sure  that  the  object  collided  with  was  not  a 
missile. 


2)  When  we  receive  a  collision  packet  from  another  vehicle  simulation,  this  routine 
calculates  firom  which  direction  we  were  hit  Note  that  if  a  collision  packet  is  received  from 
another  vehicle,  we  confirm  a  collision  whether  or  not  we  actually  detected  it  (the 
confirmed  hit  flag  is  set).  If  nothing  is  in  range  after  a  collision  packet  has  b^n  received, 
we  assume  that  the  other  vehicle  backed  off  and  we  clear  the  collision. 


Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

out  biQwheel 

pointer  to  int 

Standard 

confirmed  hit 

int 

Standard 

hash  id 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

loc  biQwh 

pointer  to  BIGWHEEL 

Section  2.5.10.2 

otherJankjDOs 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

loc 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

0_tj30S 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  types.h 

compute_sqr_range() 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

rear_r 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

left_r 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

right_r 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

1  Calls  1 

Function 

Where  Described 

rva  aet  object  type 

Section  2.5.12.5.1 

rva  aet  veh  loc 

Section  2.5.12.8.1 

compute  sqr  ranae 

Section  2.5.10.9.1 

collision  detected 

Section  2.5.10.6.3 

collision  cleared 

Section  2.5.10.6.2 

Table  2.5>215:  collison  check  veh  coll  at  Information. 
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2.5.10.6.2  collision_cleared 

This  routine  clears  a  collision  if  no  vehicle  is  in  range  after  a  collision  packet  has  been 
received.  Note  that  in  theory,  a  vehicle  can  collide  with  more  than  one  object.  This  routine 
checks  to  see  if  the  cause  of  the  clear  is  equal  to  the  cause  of  the  collision  in  case  you  are 
stiU  collided  with  something  else. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

loc  biowh 

pointer  to  BIGWHEEL 

Section  2.5.10.2 

coll  dir 

int 

Standard 

cause 

int 

Standard 

Table  2.5-216:  conision_cleared  Information. 

2.5.10.6.3  collision_detected 

This  routine  is  called  when  a  collision  is  detected.  The  routine  ignores  multiple  collisions 
on  the  same  side  of  the  vehicle,  therefore  the  network  may  not  necessarily  be  called  to  send 
out  a  collision  packet  for  every  collision.  Note  that  the  newly  collided  vehicle  should  still 
send  a  packet;  there  should  always  be  a  record  of  the  collision. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

loc  bigwh 

pointer  to  BIGWHEEL 

Section  2.5.10.2 

coll  dir 

int 

Standard 

cause 

int 

Standard 

Internal 

Variables 

Variable 

Where  Tvpedef  Declared 

coll  eventid 

1  int 

Standard 

1  Calls  1 

Function 

Where  Described 

event  oet  eventid 

Section  2.6.9.1.1 

Table  2.5-217:  collision  detected  Information. 
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2.5.10.6.4  collision_forget_about 


This  routine  is  called  to  clear  away  a  collision  if  the  vehicle  you  collided  with  is  deactivated. 
The  collision  is  cleared  and  your  vehicle  forgets  that  it  was  in  a  collision. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

out  biawheel 

pointer  to  int 

Standard 

hash  id 

int 

Standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

loc  biowh 

pointer  to  BIGWHEEL 

Section  2.5.10.2 

Table  2.5>218:  collision_forget_about  Information. 
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2.5.10.7  init  suppt.c 

(/simnet^ea^sic/vehicle/libsic/libbigwh/init_suppLc) 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"bigwhJoc.h" 

"bigwheeLh" 

"Ubmatrix.h" 

"libteirain.h" 

"libsusp.h" 

Procedure  Declarations: 

bigwh_init_height() 

2.5.10.7.1  bigwheel_init_support_plane 

When  setting  up  the  simulation,  the  first  chunk  of  terrain  is  necessary  to  ctnnpute  the 
orientation.  Tliis  routine  is  called  by  kinematics  vehicle_init()  to  get  an  initial  value 
for  the  unit  normal,  u  norm.  If  terrain  coverage  islncomplete,  then  the  vehicle  should  not 
be  initialized,  so  this  routine  returns  FALSE.  If  terrain  coverage  is  complete,  then  the  unit 
normal  is  initialized  and  this  routine  returns  TRUE. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

out  biawheel 

pointer  to  int 

Standard 

h_to_w 

register  T_MATRIX 

h_to_o 

register  VECTOR 

/simnet/common/include/glob 
al/sim  types. h 

u_norm 

register  VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

loc  biowh 

pointer  to  BIGWHEEL 

Section  2.5.10.2 

1  Return  Values  1 

Return  Value 

Type 

Meanlno 

TRUE 

int 

unit  normal  is  initialized 

FALSE 

Int 

incomplete  terrain  coverage 

1  Calls  1 

Function 

Where  Described 

biowh  init  heioht 

Section  2.5.10.7.2 

bi^heei  cai  unit  normal 

Section  2.5.10.3.1 

suspension  veh  init 

Section  2.5.6.7.1 

Table  2.5'2]9:  bigwheel_init_support_plane  Information. 
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2.5.10.7.2  bigwheeMnit_height 

This  routine  called  from  bigwheel  init_support_plane()  in  order  to  get  the  initial 
height  under  each  wheel.  Ibe  routine  makes  a  call  to  terrain  calc_elev()  to  calculate  the 
elevation  under  each  wheel;  the  height  is  pointed  to  in  the  vari^le  g^loc. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

loc  biowh 

pointer  to  BIGWHEEL 

Section  2.5.10.2 

wheel  num 

int 

Standard 

h_to_o 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

h_to_w 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

a  loc 

pointer  to  reaister  REAL 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

int 

terrain  coverage  complete 

FALSE 

int 

terrain  coverage  not  complete 

1  Calls  1 

Function 

Where  Described 

vec  sub 

Section  2.6.2.65 

vec  mat  mul 

Section  2.6.2.56.1 

terrain  calc  elev 

Section  2.5.11.1.1 

Table  2.5>220:  bigwh_init_height  Information. 

2.5.10.8  set_suppt.c 

(/simnet/release/src/vehicle/Iibsrc/libbigwh/set_suppt.c) 

Include: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"bigwhjoc.h" 

"libterrain.h" 

"libmatrix.h" 

"libsusp.h" 

"bigwheel.h" 

Procedure  Declarations: 

reg_gnd_wheel() 

getjheight_under_wheel() 
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2.5.10.8.1  bigwhec^_scit_SHpport_plane 

This  routine  is  called  eadb  tid:  to  pet  the  unit  normal,  u  norm,  of  the  hull  to  world  matrix, 
hjo  w,  and  hull  to  origin  vecator,  hjo  o^  for  the  vehicle.  This  information  is  used  to  cant 
the  vehicle  to  one  side  » trade  is  tfuown. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

out  biawheel 

ipoinher  toint 

Standard 

hjo_w 

!  register  T_MATRIX 

/simnet/common/include/glob 
al/sim  types.h 

h_to_o 

1  register  VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

u_norm 

^  register  VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

loc  biowh 

pointer  to  BIGWHEEL 

Section  2.5.10.2 

height 

;  register  REAL 

/simnet/common/include/glob 
al/sim  types.h 

wheel  down 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

reo  and  wheel 

Section  2.5.10.8.2 

blQwheel  cal  unit  normal 

Section  2.5.10.3.1 

suspension 

Section  2.5.6.6.1 

Table  2.5-221:.  bigwheel_set_support_pIane  Information. 
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2.5.10.8.2  reg_gnd_wheel 

The  regular  ground  wheel  routine  checks  for  collisions  against  the  terrain  by  getting  the 
height  under  each  wheel.  If  the  height  return  is  greater  than  the  location  and  the  track 
offset,  the  routine  calls  coIlision_detected().  This  routine  also  allows  the  vehicle  to 
continue  moving  at  the  same  angle  if  a  piece  of  terrain  is  missing. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

loc  biawh 

pointer  to  BIGWHEEL 

Section  2  5.10.2 

wheel  num 

int 

Standard 

h_to_o 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

h_to_w 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

track_offset 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

height 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

loc.wheel 

register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

The  unit  normal  is  out  of  range 

TRUE 

int 

The  unit  normal  is  acceptable 

1  Calls  1 

Function 

Where  Described 

get  height  under  wheel 

Section  2.5.10.8.3 

collision,  detected 

Section  2.5.10.6.3 

collision  cleared 

Section  2.5.10.6.2 

Table  2.5-222: 


reg_gnd_wheel  Information. 
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2.5.10.8.3  get_height_under_wheel 

This  routine  returns  the  height  of  the  supporting  terrain  under  the  specified  wheel. 


Parameters 


Parameter 


wheel  num 


h  to  0 


inter  to  BIGWHEEL 


int 


VECTOR 


T  MATRIX 


Where  TvDedef  Declared 


Section  2.5.10.2 


Standard 


/simnet/common/include/glob 
al/sim  types. h 


/simnet/common/include/giob 
al/sim  types. h 


Variable 


loc  wheel 


Internal  Variables 


e 


pointer  to  register  REAL 


\Em 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/sim  types.h 


Return  Value 


height 


ID73 


Return  Values 


e 


REAL 


Meanin 


the  height  under  the  wheel 


Calls 

Function 

Where  Described 

vec  sub 

Section  2.6.2.65 

vec  mat  mul 

Section  2.6.2.56.1 

terrain  calc  elev 

Section  2.5.11.1.1 

Table  2.5-223:  get_height_under_wheel  Information. 
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2.5.10.9  sqr_range.c 

(/simnetA«ilease/srcArehicleAibsrc/libbigwh/sqr_range.c) 


Includes; 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"bigwhjoc.h" 

"bigwheel.h" 


2.5.10.9.1  compute_sqr_range 


This  routine  checks  the  distance  between  two  points  standard  and  returns  the  two- 
dimensional  (x-y)  distance  squared. 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

Vl 

pointer  to  register  REAL 

/simnet/common/include/glob 

al/simJvpes.h 

v2 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

range 

register  REAL 

/simnet/common/include/glob 
al/sim  tvoes.h 

dist 

register  REAL 

/simnet/common/include/glob 
al/siri  tvoes.h 

1  Return  Values  1 

Return  Value 

Meanina 

range 

register  REAL 

The  square  of  the  two- 
dimensional  distance 

Table  2.5-224:  compute_sqr_range  Information. 


1141 


BBy  Sjyaiiems  and  Technologies 


Vehicles  CSa 


I.S.XQ^IO  tracks_stat.c 

(^uinnetAelease/sic/vehicIeAibsrc/Iibbigwh/tracks_statc) 


Inchides: 

"atdio.h" 

"laaath.h" 

"sBiin_dftis.h" 

''Miin_macros.h" 

’'^un_types.h" 

’%igwhJoc.h" 


2.5. 10.. 10.1  bigwheel_left_track_broken 

This  routiiiie  is  called  to  indicate  that  the  left  track  has  thrown. 


1  Parameters  1 

Parametter 

Where  Typedef  Declared 

out  blQwIneel 

pointer  to  int 

Standard 

Table  2.5*225:  bigwheelJeft_track_broken  Information. 
2 . 5 . 1 0 .  A  0 . 2  bigwheel_right_track_broken 


This  roudne  is  called  to  indicate  that  the  right  track  has  thrown. 


1  Parameters  1 

Parametisr 

Where  Typedef  Declared 

out  biawlKieel 

pointer  to  int 

Standard 

Table  2.5*226:  bigwheel_right_track_broken  Information. 
2.5.10.10.3  bigwheel_repair_tracks 
This  rouiane  is  called  to  repair  a  thrown  track. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

out  biow^el 

pointer  to  int 

Standard 

Table  2.5*227:  bigwheel_repair_tracks  Information. 


2.5.10.  11  veh  init.c 

(/simnet^ease/src/vchicle/libsrcdibbigwh/vehJniLc) 


This  file  initializes  space.  It  allocates  space  when  the  vehicle  is  initialized  and  deallocates 
when  the  vehicle  is  unitialized. 
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2.5.11  libterrain 

(/simnetAclease/sic/libsrc/libteiTain  [libterrain]) 

As  the  database  hands  terrain  polygons  to  the  simulation,  the  bigwheel  points  must  be 
chected  for  inclusion  on  the  new  polygons.  The  soil  type  of  the  new  polygons  must  be 
available  to  the  vehicle  specific  drivetrain  simulation  for  drag  computation,  and  the 
bounding  volumes  of  any  structures  on  the  polygon  must  passed  on  for  collision  checking. 
This  library  provides  all  the  routines  for  these  computations,  and  conununicates  them 
mostly  to  Ubbigwheel. 

This  file  preprocesses  the  terrain  polygons  which  are  received  from  the  CIG.  This 
processing  allows  for  quick  point  inclusion  and  should  work  quickly,  even  on  detailed 
micro-terrain. 

Approximately  every  37  ticks,  a  patch  of  local  terrain  is  received  fiom  the  graphics  box. 
This  patch  contains  every  polygon  and  bounding  volume  that  is  within  a  250  x  250  meter 
area  centered  around  the  vehicle's  location  rounded  to  the  nearest  125  meters  (in  both  x  and 
y).  TTie  local  world  is  divided  up  into  four  "buckets",  which  are  conceptually  the  terrain  to 
the  southwest,  southeast,  northwest,  and  northeast  of  the  rounded  location. 

The  bucket  (or  buckets)  that  each  polygon  or  bvol  falls  in  is  determined,  and  a  pointer  is 
placed  to  each  polygon  or  bvol  in  the  bucket  Hien,  when  an  elevation  is  calculated  at  a 
particular  point  only  one  fourth  as  many  polygons,  on  average,  must  be  considered. 

When  terrain__calc__elev()  is  called  to  determine  the  elevation  of  a  supporting  polygon  at 
a  given  (x,y)  location,  the  following  point  inclusion  algorithms  are  used  to  determine  which 
polygons  support  that  location: 

1)  Determine  which  bucket  the  (x,y)  location  falls  in,  and  only  look  at  the  polygons  in 
that  bucket 

2)  Check  against  the  bounding  box  that  surrounds  the  polygon.  If  the  check  fails,  go  on 
to  the  next  polygon. 

3)  Perform  a  true  point  inclusion  check,  using  the  edges  of  the  polygon.  This  algorithm 
is  described  for  the  routne  terrain_inside(). 
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2.5.11.1  calc  elev.c 

(/simnet/teIease/sic/libsrc/libteiTain/calc_elev.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_<tfns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"terrainjoc.h" 

"libmatrix.h" 

"bbd.h" 

Procedure  Declarations: 
terrain_inside() 
check^poly  s_incl  ( ) 
check~bvols_incl() 
terrain_get  heightO 
terrain~ma1ce_edges() 
terrain_make3torinal() 

Defines: 

GET_CROSS()  --  This  macro  is  called  to  determine  on  which  side  of  a  line 

segment  the  given  (x,y)  point  lies.  The  value  returned  is 
important  only  for  its  si^um  (i.e.  whether  it  is  positive  or 
negative).  A  return  of  0.0  indicates  that  the  point  lies 
dii^tly  on  the  line  segment.  The  macro  is  called 
GET_CROSS  because  it  computes  a  cross  product  of  two 
vectors  in  the  x-y  plane.  The  result  is  the  z-value  of  the 
resulting  vector. 
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2.5.11.1.1 


terrain  calc  elev 


This  routine  is  called  to  determine  the  height  of  supporting  terrain  at  a  given  (x,y)  point  If 
no  supporting  terrain  is  found,  -1.0  is  returned.  Note  that  currently,  the  highest  terrain  at 
any  given  point  is  returned,  if  multiple  supporting  surfaces  are  found. 


The  parameter,  out _patch,  is  a  pointer  to  the  chunk  of  local  terrain  information  passed  in  by 
the  graphics  handler.  The  parameter,  location,  is  the  given  (x,  y)  point  at  which  to 
determine  the  height 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

out_Datch 

pointer  to  int 

Standard 

location 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i  morr 

int 

Standard 

loc  oatch 

pointer  to  TERRAIN  PATCH 

terrain  loc.h 

support  polv  found 

reaister  int 

Standard 

local  X 

reaister  int 

Standard 

local  V 

reaister  int 

Standard 

cur_height 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

cur bucket 

pointer  to  register  BUCKET 

terrain  loc.h 

1  Return  Values  1 

Return  Value 

Meaning 

-1.0 

REAL 

no  supporting  terrain 

cur_height 

REAL 

the  height  of  the  supporting 
terrain 

Table  2.5-228:  terrain  calc  elev  Information. 
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2.5.11.1.2  check_polys_incl 


This  routine  checks  all  polygons  in  the  bucket,  cur_bucket,  against  the  location,  location. 

A  supporting  polygon  at  the  location  is  found  through  the  following  steps: 

1)  Check  the  polygon's  bounding  box  polygon  against  the  point.  If  the  point  falls  outside 
the  bounding  Irox,  foen  the  point  falls  outside  the  polygon.  Continue  to  the  next  polygon. 

2)  If  the  array  of  edges  associated  with  the  polygon  has  not  been  calculated  yet,  then  ^1 
terrain  niake_edges(). 

3)  Use  3ie  array  of  edges  to  do  a  true  point  inclusion  check,  described  in  the  routine 
terrain_inside().  If  this  check  fails,  then  the  point  definitely  falls  outside  the  polygon. 
Continue  to  the  next  polygon.  Otherwise,  a  height  needs  to  be  calculated. 

4)  If  a  normal  to  the  polygon  has  not  yet  been  created,  then  call  terrain_inake_noniial() 

to  create  a  normal,  which  is  not  necessarily  a  unit  normal.  ~ 

5)  Call  terrain  Bet_height()  to  determine  the  height  at  that  location.  If  the  returned 
height  is  higher  any  height  found  so  far,  then  it  becomes  the  current  height. 

Afto  all  the  polygons  have  bwn  examined,  return  the  flag,  support  j)oly_found,  if  a 
support  polygon  was  found.  The  highest  height  is  pointed  to  by  the  variable  cur  height. 


Parameters  I 

Parameter 

Where  Tvpedef  Declared 

cur  bucket 

pointer  to  BUCKET 

terrain  loc.h 

location 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  types.h 

cur_height 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

soil  tvoe 

pointer  to  int 

Standard 

Internal  Variables  I 

Variable 

Where  Typedef  Declared 

i 

register  int 

Standard 

curjjoly 

pointer  to  register 

BBN  POLY  ENTRY 

terrainjoc.h 

incl_field 

pointer  to  register 

BBN  INCL  INFO 

terrainjoc.h 

vertices 

pointer  to  register  R4P3D 

/simnet/common/include/glob 
al/dgi  stdg.h 

support  poly  found 

int 

Standard 

test_height 

register  REAL 

/simnet/common/include/glob 
al/sim  types.h 

1  Return  Values  1 

Return  Value 

Meaning 

support  polv  found 

int 

a  support  polygon  was  found 

1  Calls  1 

Function 

Where  Described 

terrain  make  edaes 

Section  2.5.11.1.7 

terrain  inside 

Section  2.5.11.1.5 

terrain  make  normal 

Section  2.5.11.1.6 

terrain  get  height 

Section  2.5.11.1.4 

Table  2.5-229: 


check_poIys_incl  Information. 
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2.5.11.1.3  check__bvols_incl 

This  routine  checks  all  bvols  in  the  given  bucket,  cur  bucket,  against  the  given  location, 
location.  A  supporting  bvol  at  the  location  is  found  through  the  following  steps.  Note  the 
similarities  to  the  routine  check_polys  inclQ: 

1)  Check  the  bounding  volume  against  the  point.  It  will  be  obvious  if  the  point  falls 
outside  the  bounding  volume.  Continue  to  the  next  bounding  volume. 

2)  If  the  array  of  edges  associated  with  the  bounding  volume  has  not  been  calculated  yet, 
then  call  terrain_make_edges(). 

3)  Use  the  array  of  edges'  to  do  a  true  point  inclusion  check,  described  in  the  routine 
terrain_insideO-  If  this  check  fails,  then  the  point  definitely  falls  outside  the  bvol. 
Continue  to  the  next  bvol.  Otherwise,  a  height  needs  to  be  calculated. 

4)  Since  bvols  are  flat,  there  is  no  point  in  creating  a  normal  to  the  bvol.  Instead,  the 
height  is  calculated.  Since  bvols  have  a  uniform  height,  there  is  no  need  to  call 
terrain  get_heightO  to  determine  the  height  of  the  bvol.  If  the  calculated  height  is 
higher  tEan  ^y  height  found  so  far,  then  it  becomes  the  current  height. 

After  all  the  polygons  have  been  examined,  return  the  flag,  support JfvolJound,  if  a 
support  bvol  was  found.  The  highest  height  is  pointed  to  by  the  variable  height. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

cur  bucket 

pointer  to  BUCKET 

terrain  loc.h 

location 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  types.h 

height 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

incIJiekJ 

pointer  to  register 

BBN  INCL  INFO 

terrainjoc.h 

cur_bvol 

pointer  to  register 

BBN  BVOL  ENTRY 

terrainjoc.h 

heightjield 

pointer  to  register 

BBN  HEIGHT  INFO 

terrainjoc.h 

test_height 

register  REAL 

/simnet/common/include/glob 
al/sim  types.h 

suPDort  bvol  found 

int 

Standard 

i 

register  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

support_bvol_found 

int 

a  supporting  bounding 
volume  was  found 

1  Calls  1 

Function 

Where  Described 

terrain  make  edoes 

Section  2.5.11.1.7 

terrain  inside 

Section  2.5.11.1.5 

Table  2.5*230:  check  bvols  incl  Information. 
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2.5.11.1,4  fterrain_get_height 

This  routine  recalled  by  check_polys_incl()  when  the  (x,y)  point,  pt,  has  passed  the 
inclusion  ched^  for  the  particular  polygon.  This  routine  returns  the  height  of  the  point  on 
the  polygon  at  dhat  location.  The  algorithm  uses  the  fact  that  the  dot  product  of  a  vector 
nor^  to  thepcdlygon  with  a  vector  that  lies  in  the  plane  of  the  polygon  must  be  equal  to 
zero.  The  nannial  vector  to  the  polygon  will  already  have  been  determined.  Since  a  vector 
which  lies  in  the  plane  of  the  polygon  can  be  determined  by  subracting  any  vertex  of  the 
polygon  firom^e  (x,y)  point  being  checked,  the  dot  product  of  these  two  vectors  can  be  set 
to  zero,  leaving  (Only  one  unknown,  the  z  value  of  the  vector  that  lies  in  the  plane  of  the 
polygon.  Solvhng  for  this  value  gives  the  height  at  the  (x,y)  legation  above  the  z  value  of 
the  vertex  use(L 


Parameters 


Parameter 


pt 


heightjield 


I  Bn 


pointer  to  register  REAL 


pointer  to  register 
BBN  HEIGHT  INFO 


Where  Tvoedef  Declared 


/simnet/common/include/glob 
al/sim  tvoes.h 


terrain  loc.h 


Internal  Variables 


Variable 

Where  Typedef  Declared 

vert 

pointer  to  register  REAL 

/simnet/commonyinclude/glob 
al/sim  tvpes.h 

norm 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

height 

register  REAL 

/simnet/common/include/glob 
al/sim  tvoes.h 

Return  Value 


height 


I  Bn 


Return  Values 


e 


REAL 


Meanin 


the  height  of  the  polygon  at 
the  (x.v)  location 


Table  2.5-231:  terrain_get_height  Information. 
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2.5.11.1.5  terrain_inside 

This  routine  implements  a  true  point  inclusion  algorithm  by  determining  if  the  point  being 
tested  falls  on  the  same  side  of  every  edge  of  the  polygon.  This  algorism  assumes  that  Si 
polygons  are  convex,  and  that  a  list  of  edges  has  alre^y  been  made. 

The  cross  product  is  taken  (using  only  the  x  and  y  components)  of  a  vector  which 
represents  an  edge  between  two  vertices  of  the  polygon,  and  a  vector  which  is  drawn  from 
the  first  vertex  to  the  point  being  tested.  Only  the  z  value  of  the  resulting  vector  is  non¬ 
zero.  To  determine  which  side  of  an  edge  the  point  lies  on,  the  signum  of  the  z  value  of  the 
resultant  vector  is  examined.  If  the  z  vtdue  is  zero,  then  the  point  lies  on  the  edge,  which 
neither  allows  nor  prevents  inclusion.  If  the  point  being  tested  falls  on  the  same  side  of 
every  edge  of  the  polygon,  then  the  signum  of  the  z  value  will  be  the  same  for  every  edge. 
Therefore,  the  psuedo-code  for  this  algorithm  is: 
signum  =  -1 
do  { 

ret  =  check  the  z  value  of  the  cross  porduct 
if  (ret  !=0.0) 

signum  =  ( ret  >  0.0 ); 
increment  vertex  counter 
} 

while  ( signum  !=  -1 ) 

while  (  vertex  counter  !=  num_vertices ) 

{ 

ret  =  check  the  z  value  of  the  cross  porduct 
if  ( signum  !  =  ( ret  >  0.0 )  &&  ret  !=  0.0 ) 
return  ( FALSE ) 
increment  vertex  counter 
) 

return  ( TRUE ) 

The  parameters  to  the  routine  represent  the  following: 
pt  -  the  point  being  tested 

incl  jnfo  -  provides  the  list  of  edges  for  the  polygon 
vertex  jist  -  the  listing  of  vertex  points  for  the  polygon 
num_verts  -  the  number  of  vertices  in  the  polygon 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

pt 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

inci  info 

DOintertoBBN  INCL  INFO 

terrain  loc.h 

vertexjist 

pointer  to  R4P3D 

/simnet/common/include/glob 
ai/dai  stdq.h 

num  verts 

int 

Standard 
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Vaiitable 


vert  cnt 


dir 


z_va^e 


cunL_edge 


currLvertex 


Internal  Variables 


e 


REAL 


int 


int 


REAL 


pointer  to  REAL 


pointer  to  R4P3D 


Where  Tvpedef  Declared 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


Standard 


Standard 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/dQi  stdQ.h 


Returrn  Value 


INSIDE  . 


OUTSIDE 


Return  Values 


Meanin 


the  point  is  located  inside  the 


Function 


GET  CROSS 


Calls 


Where  Described 


Table  2.5-232:  terrain  inside  Information. 
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2.5.11.1.6  terrain_inake_normaI 

This  routine  creates  a  normal  to  the  polygon  by  taking  the  cross  product  of  two  of  the 
vectors  which  represent  two  of  its  edges.  The  routine  is  also  used  to  fill  in  portions  of  the 
BBN_HEIGHT_INFO  structure  from  informadon  passed  from  the  graphics  box.  Note 
that  this  routine  is  only  called  for  polygons,  not  bvols,  since  by  definition,  all  bvols  are 
flat. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

vertex 

pointer  to  R4P3D 

/simnet/common/include/glob 
al/dQi  stdQ.h 

edgejist 

pointer  to  VECTOR 

/simnet/common/include/glob 
al/sim  types. h 

heightjield 

pointer  to 

BBN  HEIGHT  INFO 

terrainjoc.h 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

first 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

second 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  types. h 

normal 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  types. h 

init_pt 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  types.h 

Table  2.5-233:  terrain  make  normal  Information. 


2.5.11.1.7  terrain_make_edges 


This  routine  uses  the  vertices  of  a  polygon  to  create  a  vector  for  each  edge  of  the  polygon. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vertices 

pointer  to  R4P3D 

/simnet/common/include/giob 
al/doi  StdQ.h 

edgejist 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

vert  cnt 

reoister  int 

Standard 

1  Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

reoister  int 

Standard 

current 

pointer  to  register  R4P3D 

/simnet/common/include/glob 
al/doi  StdQ.h 

next 

pointer  to  register  R4P3D 

/simnet/common/include/glob 
al/doi  StdQ.h 

edge 

pointer  to  register  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

Table  2.5-234:  terrain_make_edges  Information. 
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2.5.11.2  lect  size.c 

(/siimnst]h3ease/sir/Ubsrc/libteiTain/get_size.c) 

Includes: 

"stdi<s.h" 

"maAi.'h"' 

’'siin_jtypesuh" 

"siin_idfnsJh" 

'’sim_aiiaaB«)s.h" 

''inass_atdc.h" 

"dgi_»idgJb" 

"siin_cig_i£*" 

"teirwin_locA" 

2.5.11.2.1  terrain_get_patch_size 

This  routine  Is  usexl  to  determine  the  size  of  a  specific  patch  of  terrain,  and  is  called  by 
those  who  need  to  allocate  their  own  patch. 


1  Return  Values  1 

Return  valu«e 

Meanina 

Sizeof(TERRAIIN_F^TCH) 

int 

Size  of  TERRAIN_PATCH  in 
bytes. 

TaUe  2.5-235;  terrain_get_patch_size  Information. 
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* 


2.5.11.3  get_soil.c 

(/simnet/release/src/libsrcyiibterrain/get_soil.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

''sim_<tfns.h" 

"sim_macros.h" 

"inass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"terrain_lcx:.h" 

2.5.11.3.1  terrain_get_terrain_ty  pe 

This  routine  is  called  by  the  tracks  dynamics  to  determine  what  type  of  soil  the  tank  is 

travelling. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

out  patch 

pointer  to  int 

Standard 

1  Internal  Variables  1 

1  Variable 

Where  Tvpedef  Declared 

lloc  patch 

pointer  to  TERRAIN  PATCH 

terrain  loc.h 

1  Return  Values  1 

Return  Value 

Meanina 

SOIL_ROAD 

int 

the  current  soil  is  ot  typi 

SOIL  ROAD 

loc  patch->cur  soil  type 

int 

the  current  soil  type 

Table  2.5'236:  terrain_get_terrain_type  Information. 

2.5.11.4  It  inited.c 

(/simnet7rclease/src/libsrc/libterrain/lt_inited.c) 

Includes; 

"stdio.h" 

•'math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"terrainjoc.h" 
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2.5.11.4.1  terrain  It  inited 


This  routine  is  called  by  kinematics  during  the  initial  frames  until  the  first  terrain  patch  is 
received.  If  this  returns  FALSE,  then  kinematics  will  not  initialize. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

out  patch 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

the  local  terrain  has  not  been 
initialized 

({TERRAIN_PATCH  *) 
out  patchl  ->terrain  inited 

int 

the  local  terrain  has  been 
initialized 

Table  2.5-237:  terrain  It  inited  Information. 


2.5.11.5  obstacles.c 

(/simnet/release/src/libsrc/libterrain/obstacles.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_<frns.h" 

"sim_macros.h" 

"mass_stdc-h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"terrain_loc.h" 
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2.5.11.5.1 


terrain  obstructed 


This  routine  is  called  to  determine  if  the  area  at  the  given  location  with  the  given  radius  is 
obstructed  by  any  bounding  volume.  If  the  area  is  not  obstructed,  0  is  returned. 
Otherwise,  the  type  of  the  obstructing  bvol  is  returned. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

out  patch 

pointer  to  int 

Standard 

location 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

radius 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

reqister  int 

Standard 

local  X 

reaister  int 

Standard 

local  V 

reqister  int 

Standard 

cur_bucket 

pointer  to  reqister  BUCKET 

terrain  loc.h 

cur_bvol 

pointer  to  register 

BBN  BVOL  ENTRY 

terrainjoc.h 

minx 

short 

Standard 

minv 

short 

Standard 

maxx 

short 

Standard 

maxv 

short 

Standard 

loc  patch 

pointer  to  TERRAIN  PATCH 

terrain  loc.h 

Return  Values  1 

Return  Value 

Type 

Meaning 

-1.0 

unsiqned  short 

the  procedure  failed 

FALSE 

unsigned  short 

the  location  is  not  obstructed 
by  a  bounding  volume 

cur_bvol->bvol.type_id 

unsigned  short 

the  location  is  obstructed  by  a 
bounding  volume 

Table  2.5-238:  terrain  obstructed  Information. 


1155 


BBN  Systems  and  Technologies 


Vehicles  CSa 


2.5.11.6  preproc.c 

(/simnetAelease/src/libsrc/libtBiTain^pieproc.c) 

Includes: 

’'stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"terrain_loc.h" 

"bbd.h’’ 

"Ubmatrix.h" 

Declarations: 

terrain_add_poly_ptr() 
terrain”add_bvol~ptrO 
dgi_verbbse  ” 

2.5.11.6.1  terrain_preproc_terrain 

This  is  the  driver  routine  for  setting  up  the  pieprocessed  polygons  and  bvols.  First,  it 
initializes  the  array  of  buckets  to  zeros.  Then,  for  each  polygon  and  bvol  it  1)  sets  Ae 
edges jnade  and  normal jnade  flags  to  FALSE,  2)  bcopies  the  polygon  into  local 
structures,  and  3)  calls  add  jpoly_ptr()  to  place  a  pointer  to  the  polygon  in  each  bucket 
that  the  polygon  overlaps.  ” 

The  parameters  represent  the  following: 

out  j>atch  -  local  terrain  information  received  from  the  graphics  box 
num  jpolys  -•  the  number  of  polygons 

dgi _poly  arraylJ  -the  array  of  polygons  in  the  Delta  Graphics,  Inc.  format 
num  bvols  --  Ae  number  of  bounding  volumes 
dgiJBvoljirrayl ]  --  the  array  of  bvols  in  the  Delta  Graphics,  Inc.  format 
position  —  the  (x,y,z)  coordinates  of  the  current  position. 
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Variable 


loc_patch 


dgij50ly 


(dgLbvol 


locjwly 


Internal  Variables 


e 


pointer  to  register 
TERRAIN  PATCH 


reoisler  int 


int 


pointer  to  register 
LT  POLY  ENTRY 


pointer  to  register 
LT  BVOL  ENTRY 


pointer  to  register 
BBN  POLY  ENTRY 


pointer  to  register 
BBN  BVOL  ENTRY 


Where  Tvpedef  Declared 


terrainjoc.h 


Standard 


Standard 


/simnet/common/include/cigj 
f/sim  cio  if.h 


/simnet/common/include/cigj 
f/sim  cio  if.h 


terrainjoc.h 


terrain  loc.h 


Error 


stderr 


Errors 


Reason  for  Error 


PANIC  standard  bogosities  located  in 
reproc  terrain 


Function 


terrain  add  poly  otr 


terrain  add  bvol  ptr 


Calls 


Where  Described 


Section  2.5.11.6.2 


Section  2.5.11.6.3 


Table  2.5-239:  terrain_preproc_terrain  Information. 
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2.5.11.6.2  terrain_add_poly_ptr 

This  routine  takes  a  polygon,  poly  jo_add,  and  places  a  pointer  to  it  in  the  bucket  array. 
Generally,  all  terrain  polygons  will  be  on  a  125  meter  grid,  relative  to  the  middle  x  and 
middle  y  for  the  patch  of  terrain.  However,  since  the  terrain  polygons  became  relaxed,  it  is 
now  possible  that  a  polygon  may  cover  more  than  one  bucket  Additionally,  bvols,  object 
polygons,  and  terrain  polygons  associated  with  micro  terrain  are  not  constrained  to  fall  on 
reg^ar  grid  at  all,  and  may  also  overlap  more  than  one  bucket. 

To  calculate  which  buckets)  the  polygon  belongs  in,  the  bounding  box  of  the  polygon  is 
examined.  Note  that  when  foe  coordinates  that  ^fine  the  bounding  box  are  access^  they 
are  saved  for  future  use  by  foe  first  inclusion  algorithm.  Then,  a  pointer  to  the  polygon  is 
placed  in  every  bucket  that  foe  polygon's  bounding  box  overlaps. 


Parameter 


ifsn 


Parameters 


Where  Typedef  Declared 


loc  patch 

1  PO 

inter  to  TERRAIN  PATCH  I 

terrain  loc.h 

poly_to_add 

pointer  to  register 

BBN  POLY  ENTRY 

terrainjoc.h 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

terr  ptr 

im 

inter  to  register  BUCKET  I 

terrain  loc.h 

curjaoly 

pointer  to  register 

LT  POLY  ENTRY 

/simnet/common/include/cigj 
f/sim  cia  if.h 

incIJieW 

pointer  to  register 

BBN  INCL  INFO 

terrainjoc.h 

min  X 


mm 


max  X 


max 


reaister  int 


reaister  int 


reaister  int 


reaister  int 


reaister  int 


reaister  int 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Table  2.5-240:  terrain_add_poly_ptr  Information. 
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2.5.11.6.3  terraln_add_bvoI_ptr 

This  routine  places  the  passed  bvol  pointer,  bvoljo  add,  into  the  bucket  array  of  the  local 
terrain  patch.  Bvols  are  not  constrained  to  fall  on  regular  grid  and  may  overlap  more  than 
one  bucket. 

To  calculate  which  bucket(s)  the  bvol  belongs  in,  the  bounding  box  of  the  bvol  is 
examined.  Note  that  when  die  coordinates  that  define  the  bounding  box  are  accessed,  they 
are  saved  for  future  use  by  the  first  inclusion  algorithm.  Then,  a  pointer  to  the  bvol  is 
placed  in  every  bucket  that  the  bvol's  bounding  box  overlaps. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

loc  patch 

pointer  to  TERRAIN  PATCH 

terrain  loc.h 

bvol_lo_add 

pointer  to  register 

BBN  BVOL  ENTRY 

terrainjoc.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

terr  ptr 

pointer  to  register  BUCKET 

terrain  loc.h 

cur_bvol 

pointer  to  register 

LT  BVOL  ENTRY 

/simnet/common/include/cigj 
f/sim  cig  if.h 

incljield 

pointer  to  isgister 

BBN  INCL  INFO 

/simnet/common/include/cigj 
f/sim  cig  if.h 

i 

register  int 

Standard 

i 

register  int 

Standard 

min  X 

register  int 

Standard 

min  V 

register  int 

Standard 

max  X 

register  int 

Standard 

max  V 

register  int 

Standard 

Table  2.5>241:  Information. 


2.5.11.7  terr  init.c 

(/simnet/reTease/src/libsrc/libterrain/terr_initc) 

2.5.11.8  terrainjoc.h 

(/simnetA«lease/src/libsrc/libterrain/terrain_loc.h) 

Include: 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 


Defines: 

TERRAIN_DEBUG 

MAX_POLYS_BVOLS_PATCH 

MAX_POLYS_BVOLS_LM 

TREE.PRI 

STATIC_MODEL_PRI 
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TERRAIN_PRI 

OVERLAY_PRI 

OVER_OVERLAY_PRI 

MOVING_MODEL_PRI 

MODEL_OVERLAY_PRI 

UNCOND_PRI 

INSIDE 

OUTSIDE 

Typedefs: 

BBN_INCL_INFO  —  contains  all  the  infonnation  needed  for  the  inclusion 

algorithms 

BBN_HEIGHT_INFO  —  contains  all  the  information  needed  for  the  height 

determination  algorithms 

BBN_POLY_ENTRY 

BBN_BVOL_ENTRY 

BUCKET 

TERRAIN.PATCH 

2.5.11.9  verb_mode.c 

^simnetAelease/src/libsrc/libteiTain/verb_mode.c) 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

''mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"terrain_loc.h" 

2.5.11.9.1  terrain_verbose_mode_on 

This  routine  is  called  by  ml_main  when  the  "-v"  flag  is  given  as  an  option. 
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2.5.12  librva 

(./simnet/release/src/libsrc/librva  [librva]) 

The  librva  CSU  maintains,  on  a  tick-by-tick  basis,  an  accurate  list  of  vehicles  in  the 
simulated  world.  The  librva  processes  Vehicle  Appearance  Packets  (VAP)  from  other 
vehicles  on  the  SIMNET  network.  When  a  VAP  is  received,  librva  places  the  updated 
informadon  into  its  Remote  Vehicle  Approximation  (RVA)  table.  The  RVA  table  reflects 
die  changes  in  vehicle  appearances.  Once  each  frame,  each  vehicle  is  dead  reckoned, 
vehicles  not  heard  from  in  the  last  12  seconds  are  tim^  out,  and  vehicles  in  close  proximity 
are  chected  for  servicing  needs  and  collisions.  For  efficiency,  the  librva  only  updates  its 
tables  of  vehicle  appearance  when  the  vehicle's  appearance  has  varied  in  certain  ways. 

The  libmsg  module  is  informed  of  newly  anived  vehicles  on  the  network  and  vehicles  that 
have  disappeared,  thereby  keeping  the  GIG  informed  of  the  vehicles  it  must  display. 

The  librva  module  maintains  priority  lists  of  the  simulated  vehicles  according  to  their 
vehicle  type,  force  alignment,  and  range.  When  a  Vehicle  Appearance  Packet  is  placed  in 
the  RVA  table,  it  is  also  link^  into  one  of  several  vehicle  lists,  each  of  which  represents  a 
different  priority  level.  The  highest  priority  N  vehicles  are  actually  processed,  while  any 
other  Vehicle  Appearance  Packets  are  ignored.  N  is  bound  at  run-time,  and  is  typically  64. 
In  most  cases,  fewer  than  64  vehicles  are  ever  within  visual  range  of  the  simulate  veWcle. 

2.5.12.1  adj  veh_app.c 

(.^imnet^telease/src/libsrc/librva/adj_veh_app.c) 

This  file  provides  the  capabilities  of  changing  the  appearance  of  remote  vehicles. 

Includes: 

"stdio.h" 

"math.h" 

"sim.dfns.h" 

"sim_macros.n" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"libveh.h" 

"pro_sim.h" 

"rva_loc.h". 
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2.5.12.1.1  rva_adjust_veh_appear 

This  routine  tells  the  CIG  to  change  the  appearance  of  the  remote  vehicle,  veh  jd. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

vehjd 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

guises 

pointer  to  VehicleGuises 

/simnet/common/include/prot 

ocol/basic.h 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

r 

pointer  to  register 

RVA  ENTRY 

librva.h 

hash  id 

int 

Standard 

1  Errors  I 

Error 

Reason  for  Error 

PRINT  VID  ERROR 

Cannot  adjust  appearance  of  invalid  veh  id 

1  Calls  1 

Function 

Where  Described 

rva  find  hash  entry 

Section  2.5.12.11.11 

mao  net  to  ciq 

Section  2.6.11.5.8 

Table  2.5*242:  rva_adust_veh_appear  Information. 
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2.5.12.1.2  rva_reset_veh_appear 

This  routine  tells  the  CIG  to  reset  the  remote  vehicle  specified  by  veh  id  to  its  original 
appearance. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vehjd 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

r 

pointer  to  RVA  ENTRY 

librva.h 

hash  id 

int 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

PRINT  VID  ERROR 

Cannot  reset  appearance  of  invalid  veh  id 

1  Calls  1 

Function 

Where  Described 

rva  find  hash  entry 

Section  2.5.12.11.11 

map  net  to  da 

Section  2.6.11.5.8 

Table  2.5-243:  rva_reset_veh_appear  Information. 

2.5.12.2  debug.c 

(./simnet/release/src/libsrc/librva/debug.c) 

This  file  is  used  for  debugging  purposes. 

Includes: 

"stdio.h" 

’'math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"pro_sim.h" 

"rvajoc.h" 

"prior_loc.h". 

2.5.12.2.1  rva_turn_debug_on 

This  procedure  sets  the  value  of  rva  debug  to  TRUE. 

2.5.12.2.2  rva_turn_debug_off 

This  procedure  sets  the  value  of  rva  debug  to  FALSE. 
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2.5.12.2.3  rva_diannp_priority_lists 

This  procedure  prints  tihe  priority  list  (for  debugging  purposes). 

2.5.12.3  forget_wh.c 

(ysimma5^%elease/src/libsrc/librva^orget_veh,c) 

This  file  includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h'" 

"sim_inacros.hr 

"sim_types.h" 

"inass_stdc.h:" 

"dgi_stg.h" 

"sim_cig_if.li!'" 

"pro_sim.h." 

"Ubkin.h" 

"bigwheeLh" 

"rva_loc.h" 

"prior_loc.h" 

"UbhulLh".. 
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2.5.12.3.1  rva_forget_about_vehicIe 

This  routine  removes  a  vehicle  specified  by  vehjd  from  the  RVA  table.  If  the  static 
vehicle  has  the  "is_static"  flag  set  to  TRUE,  then  the  vehicle  must  also  removed  from  the 
CIG  using  "tell_cig.c".  Otherwise,  the  CIG  never  heard  about  it.  The  vehicle  will  be 
deleted  fiom  the  priority  lists  the  next  time  the  priority  lists  are  adjusted. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

vehjd 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

r 

register  pointer  to 

RVA  ENTRY 

iibnra.h 

hash  id 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

rva  find  hash  entry 

Section  2.5.12.11.11 

collision  foraet  about 

Section  2.5.10.6.4 

prior  debua 

Macro  defined  in  Section  2.5.12.17  prior  loc.h 

delete  veh  from  da  msq 

Section  2.1.2.2.2.27.1 

Called  Bv 

Function 

Where  Described 

delete  or  timeout 

Section  2.5.12.15.3 

adjust  dynamic  vehicles 

Section  2.5.12.15.5 

adjust  static  vehicles 

Section  2.5.12.15.6 

process  known  dynamic 

Section  2.5.12.20.3 

Table  2.5-244:  rva_forget_about_vehicle  Information. 
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2.5.12.3.2  delete_vehicles_from_Iist 

This  routine  deletes  every  vehicle  fiom  the  specified  priority  list,  prijist..  As  it  deletes  a 
vehicle,  it  also  asks  the  CIG  interface  code  to  delete  the  OTHERVEH_STATE  copy  of  the 
vehicle,  if  that  copy  exists. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

pri  list 

pointer  to  PRIORITY  LIST 

prior  loc.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

veh 

pointer  to  RVA  ENTRY 

librva.h 

1  Errors  1 

Error 

Reason  for  Error 

PRINT  VID  ERROR 

Invalid  vehicle  to  delete  from  listsO 

1  Calls  1 

Function 

Where  Described 

collision  forget  about 

Section  2.5.10.6.4 

prior  degug 

Macro  defined  in  Section  2.5.12.17 

delete  veh  from  cig  msg 

Section  2.1.2.2.2.27.1 

Table  2.5'245:  delete__vehicIes_from_Iist  Information. 
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2.5.12.4  get  air_vehs.c 

(^iinnet/release/src/libsrc/librva/get_air_vehs.c) 

This  file  includes; 

"stdio.h" 

"math.h" 

*'siin_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"pro_sim.h" 

"rvajoc.h". 

2.5.12.4.1  rva_get_air_vehjist 

This  routine  maintains  a  list  of  air  vehicles  and  indirectly  returns  values  for  the  air  vehicle 

list  and  number  of  air  vehicles  on  the  list  through  the  veh  jist  and  the  num_yehs  pointers. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

vehjist 

pointer  to  pointer  to  array  of 
RVA  ENTRY 

librva.h 

num  vehs 

pointer  to  int 

Standard 

Table  2.5*246:  rva_get_veh_list  Information. 
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2.5.12.5  get  obj^type.c 

(^imnet/release/src/libsrc/librva/get_obj_type.c) 

This  file  includes: 

••stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim.macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"pio_sim.h" 

"rva_loc.h". 

2.5.12.5.1  rva_get_object_type 

Given  a  hashjd,  this  routine  returns  the  object  type  of  the  RVA  Table  entry. 


Parameters 


Parameter 


hash  id 


Where  Tvoedef  Declared 


Standard 


Return  Value 


remote_vehicles[hashJd]. 

rva_entry.pkt.guises. 

distinauished 


remote_vehlcles[hashJdj, 

rva_entry.pkt.guises. 

other 


Table 


\^m 


ObjectType 


Objectrype 


Return  Values 


Meanln 


The  object  type  of  the  Rv A 
entry  for  the  distinguished 
force  ID. 


The  object  type  of  the  RVA 
entry  for  otherForcelD 


rva_get_object_type  Information. 


2.5.12.6  get  priorjist.c 

(,/siinnet^lease/src/libsrc/librva/get_pri_list.c) 

This  file  includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

”sim_  types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"simstdio.h" 

"rvajoc.h" 

"priorjoc.h" 

"libhull.h" 

Tibkin.h" 

"libveh.h". 
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2.5.12.6.1  rva_get_priority_list 


This  routine  returns  the  index  of  the  priority  list  given  a  specific  vehicle  appearance  variant, 
vap,  and  distance,  rjsquared. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

vap 

pointer  to 

VehicleApoearanceVariant 

/simnetycommon/include/prot 
ocol/p  sim.h 

r  squared 

double 

Standard 

1  Internal  Variables  I 

Variable 

Where  Tvoedef  Declared 

i 

int 

Standard 

curr  list 

DOinier  to  PRIORITY  LIST 

Section  2.5.12.17,  prior  loc.h 

hash  id 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaninq 

i 

int 

the  priorityjist  index  for  the 
specified  vap 

-1 

int 

out  of  visual  range,  therefore, 
no  priority  list  was  found  for 
the  vehicle 

1  Calls  1 

Function 

Where  Described 

is  friendly 

Section  2.6.10.6.1 

Table  2.5>248:  rva_get_priority_Iist  Information. 
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Parameter 


hash  id 


IB7!I 


Parameters 


Where  Tvoedef  Declared 


Standard 


Variable 


r 


internal  Variables 


e 


register  pointer  to 
RVA  ENTRY 


IE27i! 


Where  Tvoedef  Declared 


librva.h 


Return  Values 


Return  Value 


&r->pkt 


NULL 


iBn 


pointer  to 

VehicleAppearanceVariant 


pointer  to 

VehicleAppearanceVariant 


Meanin 


a  pointer  to  the  vehicle 
appearance  packet  of  the 
soec'ified  vehicle  id. 


either  the  hash_id  is  equal  to 
hashJDIrrelevant  or  there  is 
no  packet. 


Table  2.5-249:  rva_get_veh_app_pkt  Information. 
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2.5.12.7.2  rva_get_rva_entry 

This  routine  returns  a  pointer  to  the  RVA  Table  entry  for  the  Vehicle  ED  specified  in 
hash  id. 


i  Parameters  1 

Parameter 

Where  Typedef  Declared 

hash  id 

int 

Standard 

1  internal  Variables  1 

Variable 

Where  Typedef  Declared 

r 

register  pointer  to 

RVA  ENTRY 

libn/a.h 

1  Return  Values  1 

Return  Value 

Meaning 

r 

pointer  to  RVA_ENTRY 

a  pointer  to  the 
remote  vehicles  rva  entry 

NULL 

pointer  to  RVA_ENTRY 

there  is  no  remote_vehicles 
rva  entry 

Table  2.5*250:  rva_get_rva_entry  Information. 

2.5.12.8  get  vehjoc.c 

(.^imnet^elease/src/libsrc/librva/get_veh_loc.c) 

This  file  includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"pro_sim.h" 

"rvajoc.h" 

2.5.12.8.1  rva_get_veh_Ioc 


This  routine  returns  the  remote  vehicles  location  of  the  Vehicle  ID  specified  in  hashjd. 


1  Parameters  1 

1  Parameter 

Where  Typedef  Declared 

lhash  id 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

remote_vehicles[hashJd]. 
rva  entry.pkt.location 

pointer  to  double 

a  pointer  to  the  remote 
vehicles  location 

Table  2.5*251:  rva_get_veh_loc  Information. 
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2.5.12.9  get  vehs.c 

(.^imnet/telease/src/libsrc/librva/get_vehs.c) 

This  file  inesludes: 

••sttiio.h" 

•’niaith.h" 

”siifflQ_(lfns.h" 

"moi_mactosJi'’ 

"am_types.h" 

"nMss_stdc.h" 

"d^_stg.h" 

"skE|_cig_if.h" 

"piK)_siin.h" 

”rvaJoc.h" 

"pri<Mr_loc.h" 

2.5.12.9.1  rva_get_close_list 

The  librva  nnaintains  a  close  vehicles  list.  Close  vehicles  are  defined  as  those  vehicles 
within  350©  meters.  This  routine  sets  the  veh  list  pointer  equal  to  the  close  vehicle  list 
{close_yeh_iist)  and  sets  the  mim_vehs  pointer  equal  to  the  number  of  close  vehicles 
lnum_close_yehs). 


1  Parameters  I 

Parameteir 

Where  Tvpedef  Declared 

vehjist 

pointer  to  pointer  to  array  of 
RVA  ENTRY 

iibrva.h 

num  vehs 

pointer  to  int 

Standard 

Table  2.5-252:  rva_get_close_Iist  Information. 
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2.5.12.9.2  rva_get_lists 
This  routine  gets  various  priority  lists: 

1)  The  static  list  pointer  is  set  to  the  static  vehicles  list  (static  veh  jist)  and  the  num  static 
pointer  is  set  to  the  number  of  static  vehicles  (num  static  vehs). 

2)  The  rmjist  pointer  is  set  to  the  remove  vehicles  list  (remove _y eh  Jist )  and  the  num  rm 
pointer  is  set  to  the  number  of  vehicles  to  remove  (rum  to  remove). 

3)  The  chgjist  pointer  is  set  to  the  change  vehicles  list  (chg  vehjist )  and  the  num_chg 
pointer  is  set  to  die  number  of  vehicles  to  change  (num_chg_vehs). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

staticjist 

pointer  to  pointer  to  array  of 
RVA  ENTRY 

librva.h 

num  static 

pointer  to  int 

Standard 

rmjist 

pointer  to  pointer  to  array  of 
RVA  ENTRY 

librva.h 

num  rm 

pointer  to  int 

Standard 

chgjist 

pointer  to  pointer  to 

RVA  ENTRY 

librva.h 

num  chq 

pointer  to  int 

Standard 

Table  2.5-253:  rva_getjists  Information. 
2.5.12.9.3  rva_get_num_hash_entries 
This  routine  returns  the  number  of  hash  entries. 


1  Return  Values  1 

Return  Value 

Meaning 

N  HASH  ENTRIES 

int 

The  number  of  hash  entries 

Table  2.5-254;  rva_get_num_hash_entries  Information. 


2.5.12.9.4  r va_ge t_n  um_cIose_ve  hs 
This  routine  returns  the  number  of  close  vehicles. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

num  close  vehs 

int 

The  number  of  close  vehicles 

Table  2.5-255;  rva_get_num_close_vehs  Information. 
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2^.ft'3.9.S  rva_get_num_air_vehs 
This  nautine  returns  the  number  of  air  vehicles. 


1  Return  Values  1 

Return  Value 

Meaning 

num  atir  vehs 

int 

The  number  of  air  vehicles 

Table  2.S-2S6:  rva_get_num_air_velis  Information. 
2.5vl2.9.6  set  save  num  static  vehs 


This  somtine  sets  the  saved  number  of  static  vehicles  in  save  num  static  vehs  ton. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

n 

int 

Standard 

Table  2.5>257:  set  save  num  static  vehs  Information. 


2.5.12.9.7  rva_get_num_static_vehs 
This  rcKutine  returns  the  number  of  saved  static  vehicles 


1  Return  Values  1 

Return.  Value 

Meaning 

save_najm_slatic_vehs 

int 

The  number  of  saved  static 
vehicles 

Table  2.5-258;  rva_get_num_static_vehs  Information. 


2.5.12.9.8  rva_get_num_m v  g_vehs 


This  nautine  returns  the  number  of  saved  moving  vehicles. 


1  Return  Values  1 

Returm  Value 

Type 

Meaning 

save_mum_mvg_vehs 

int 

The  number  of  saved  moving 
vehicles 

Table  2.5-259:  rva_get_num_mvg_vehs  Information. 
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2.5.12.10  get  vid.c 

(.^iiiinet^lease/src/libsic/Iibrva/get_vid.c) 

This  file  includes: 

'*stdio.h" 

’*math.h’* 

"sim_dfns.h" 

"siin_inacros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"pro_sim.h" 

"rvajoc.h" 


2.5.12.10.1  rva_get_veh_id 

Given  the  argument  hashjd,  this  routine  returns  a  pointer  to  the  associated  remote  vehicles 
RVA_ENTRY  Vehicle  ID. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

hash  id 

int 

Standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

r 

register  pointer  to 

RVA  ENTRY 

librva.h 

1  Return  Values  1 

Return  Value 

Meaning 

&r  ->  pkt.vehiclelD 

pointer  to  VehicieiO 

a  pointer  to  the  vehicle  ID  of 
the  specified  hash  id. 

NULL 

pointer  to  VehicleiD 

either  the  hash_id  is  equal  to 
hash_IDIrrelevant  or  there  is 
no  VehicleiD  entry. 

Table  2.5-260:  rva_get_veh_id  Information. 
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2.5.12.11  hasft.c 

(yjamni^]iirelease/src/hbsrc/Ubrva/hash.c) 

This  file  includes. 

"sdio.h” 

"sim_dfiis.h'' 

"sim_inacnQs.h'' 

"sim_types.h” 

"inass_sdc.h" 

"dgi_stg:fr" 

"sim_cigj£h” 

"assoc.h." 

"rvajoch” 

"prior_l(K.h''’ 

The  following  ptoceduies  are  declared  as  static: 
find_haaJk_vaItte() 
free'hasft'^nttryO 
gctJha^jMitryO 

The  following  variables^  are  declares: 
reinote_vdricles 
rva  hashLCMe 


2.5.12.11.1  irra_alloc_taash_table 

This  routine  creates  a  Ha^^  table  of  the  specified  size.  The  table  pointer  represents  the  hash 
table,  with  the  numbered  entries  equal  to  n_entries. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

table 

pointer  to  pointer  to 

HASH  TABLE 

Section  2.5.12.24,  rva_loc.h 

n  entries 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

-1 

Int 

The  routine  failed 

0 

int 

The  table  was  successfully 
created 

Table  2L5-261:  rva  alloc  hash  table  Information. 
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2.5.12.11.2  rva_init_hash_table 

This  routine  initializes  all  the  internal  structures  of  the  hash  table,  table,  to 
hashlDInelevant,  and  establishes  the  tinee  list  of  entries. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

table 

pointer  to  HASH  TABLE 

Section  2.5.12.24,  rva  loc.h 

n  entries 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.5-262:  rva_init_hash_table  Information. 
2.5.12.11.3  rva_lookup_hash_tabIe_entry 

This  routine  returns  hashi,  the  index  into  the  given  hash  table,  table,  which  contains  the 
entry  corresponding  to  the  vid  parameter,  or  hashIDIrrelevant  if  the  entry  does  not  exist. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

table 

pointer  to  HASH  TABLE 

Section  2.5.12.24,  rva  loc.h 

vid 

register  pointer  to  VehiclelD 

/simnet/common/include/proi 

ocol/basic.h 

I  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

entry 

register  pointer  to 

HASH  ENTRY 

rvajoc.h 

hashi 

rcQister  int 

Standard 

I  Return  Values  I 

Return  Value 

Meaning 

hashi 

register  int 

The  index  into  the  given  hash 
table  which  contains  the  entry 
corresponding  to  vid 

I  Calls  I 

Function 

Where  Described 

VEHICLEJDS_EQUAL 

Macro  defined  in 

/simnet/common/include/Qlobal/sim  macros. h 

Table  2.5-263:  rva_Iookup_hash_tabIe_entry  Information. 
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2.5.12.11.4  rva_remove_hash_table_entry 

This  routine  finds  the  hash  value  specified  by  vid  in  the  hash  table  specified  by  table, 
removes  the  entty  for  its  hash  value  (specified  by  hashi)  from  the  list  of  entries,  and  pushes 
it  onto  the  free  list  stack.  It  returns  -1  if  the  entry  does  not  exist  and  0  otherwise. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

table 

pointer  to  HASH  TABLE 

Section  2.5.12.24,  rva  loc.h 

yid 

register  pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

i  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

«ntry 

register  pointer  to 

HASH  ENTRY 

Section  2.5.12.24,  rvajoc.h 

prev_entry 

register  pointer  to 

HASH  ENTRY 

Section  2.5.12.24,  rvaJoc.h 

hashi 

reoister  int 

Standard 

hash  value 

reaister  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

0 

int 

The  entry  existed  and  was 
removed 

hashlOlrrelevant 

int 

if  hashi  is  equal  to 
hashIDIrrelevant  (which  equals 
•1),  the  entry  does  not  exist 

1  Calls 

Function 

Where  Described 

find  hash  value 

Section  2.5.12.11.6 

VEHICLEJDS_EQUAL 

Macro  defined  in 

/simnet/common/include/alobal/sim  macros. h 

free  hash  entry 

Section  2.5.12.11.7 

Table  2.5-264: 


rva_remove_hash_tabIe_entry  Information. 
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2.5.12.11.5 


rva_insert_hash_table_entry 


This  routine  returns  the  index  of  a  new  hash  table  entry  if  one  is  available  from  the  free  list. 
Otherwise,  hashIDlirelevant  is  returned. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

table 

pointer  to  HASH  TABLE 

Section  2.5.12.24,  rva  loc.h 

vid 

register  pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

hash! 

register  int 

Standard 

hash  value 

register  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

hash! 

register  int 

The  index  of  the  new  entry 

hashIDIrrelevant 

int 

if  hashi  is  equal  to 
hashIDIrrelevant  (which  equals 
-1),  there  are  no  more  entries 

1  Calls  1 

Function 

Where  Described 

aet  hash  entry 

Section  2.5.12.11.8 

find  hash  value 

Section  2.5.12.11.6 

Table  2.5-265;  rva_insert_hash_table_entry  Information. 
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2.5.12.11.6  find_hash_value 

This  routiine  returns  the  hash_yalue  of  the  Vehicle  specified  in  the  vid  argument. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

vid 

register  pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

hash  vali»e 

register  long  int 

Standard 

1  Return  Values  I 

Return  Value 

Meaning 

hash  value 

register  long  int 

The  hash  value  of  the  vid. 

Called  By 

Function 

Where  Described 

rva_remo>re  hash  table  entry 

Section  2.5.12.11.4 

rva  insert  hash  table  entry 

Section  2.5.12.11.5 

Table  2.5>266:  find_liash_value  Information. 
2.5.12.11.7  free_hash_entry 


This  routine  frees  the  specified  hash  entry  (hashi)  of  the  specified  hash  table  (table). 


1  Parameters  1 

Paramet^er 

Where  Typedef  Declared 

table 

register  pointer  to 

HASH  TABLE 

Section  2.5.12.24,  rvajoc.h 

hashi 

register  pointer  to  int 

Standard 

Table  2.5-267:  free_hash_entry  Information. 
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2.5.12.11.8  get_hash_entry 

This  routine  returns  the  next  available  hash  entry  in  the  free  list  for  the  specified  hash  table 

(table). 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

table 

register  pointer  to 

HASH  TABLE 

Section  2.5.12.24,  rva_lpc.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

hash! 

register  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

hashIDIrrelevant 

int 

The  entry  does  not  exist 

hash! 

register  int 

The  index  of  the  entry 

Table  2.5-268:  get_hash_entry  Information. 


2.5.12.11.9  rva  alloc  rva  table 


This  routine  allocates  memory  for  the  RVA  hash  table  and  sets  remote_vehicles  to  point  to 
the  entries  in  the  table. 


I  Calls  I 

Function 

Where  Described 

rya  alloc  hash  table 

Section  2.5.12.11.1 

Table  2.5-269:  rva  alloc  rva  table  Information. 


2.5.12.11.10  rva_init_rva_table 
This  routine  initializes  the  RVA  hash  table. 


1  Calls  1 

Function 

Where  Described 

rva  init  hash  table 

Section  2.5.12.11.2 

Table  2.5-270:  rva  init  rva  table  Information. 
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2.5.12.11.11  rva_find_hash_entry 

This  routine  looks  for  the  vehicle  ID  specified  by  vid  in  the  RVA  hash  table. 


Parameter 


vid 


Parameters 


e  Where  Typedef  Declared 


register  pointer  to  VehiclelD  /simnet/common/include/prot 

ocol/basic.h 


lEsn 


Return  Value  I  Type 


Return  Values 


rvaJookup_hash_table_entry  int 
rva  hash  table,  vid) 


Meanin 


The  rva_hash_table  entry. 


Table  2.5-271:  rva_find_hash_entry  Information. 
2.5.12.11.12  rva_delete_hash_entry 

This  routine  removes  the  vehicle  specified  by  vid  from  the  RVA  hash  table. 


Parameter 


vid 


Parameters 


e  Where  Typedef  Declared 


register  pointer  to  VehiclelD  /simnet/common/include/prot 

ocol/basic.h 


Return  Values 


Return  Value  Type 


rva_remove_hashjable_  int 
entry(iva_hashjable.  vid) 


Meanin 


Either  the  entry  existed  and 
was  removed,  or  the  entry  did 
not  exist. 


Table  2.5-272:  rva_delete_hash_entry  Information. 
2.5.12.11.13  rva_add_hash_entry 

This  routine  adds  the  vehicle  specified  by  vid  to  the  RVA  hash  table. 


Parameter 


vid 


Parameters 


e  Where  Typedef  Declared 


register  pointer  to  VehiclelD  /simnet/common/include/prot 

ocol/basic.h 


I  Bn 


Return  Value  1  Type 


Return  Values 


rvajnsert_hash_table_entry  int 
{rva_hash_table,  vid) 


Meanin 


Either  the  index  of  the  new 
entry  is  returned,  or  there  are 
no  more  entries. 


Table  2.5-273:  rva_add_hash_entry  Information. 
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2.5.12.12  lock^veh.c 

(ysininet/release/src/libsrc/librva/lock_veh.c) 

This  file  includes: 

"stdio.h" 

"sim_dfns.h" 

"inass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"rva_loc.h" 

"priorjoc.h" 

"libkin.h" 

"UbhulLh" 


2.5.12.12.1  rva_lock_vch_into_buf 

This  routine  puts  the  vehicle  into  the  special  priority  list  zero,  which  tells  librva  to  smooth 
the  location  orientation  between  updates.  The  only  way  that  it  can  be  removed  from  list  0  is 
by  moving  out  of  range  and  timing  out,  or  by  a  call  to  rva_unIock_veh(). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

vehjd 

pointer  to  VehicielD 

/simnet/common/include/prot 

ocol/basic.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

r 

oointertoRVA  ENTRY 

librva.h 

hash  id 

int 

Standard 

1  Errors  1 

1  Error 

Reason  for  Error 

1  PRINT  VID  ERROR 

vehicle  is  unknown 

1  Calls  1 

Function 

Where  Described 

rva  find  hash  entry 

Section  2.5.12.11.11 

zero  init  veh 

Section  2.5.12.29.1 

Table  2.5-274:  rva_lock_veh_into_buf  Information. 
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2.5.12.12.2 


rm  unlock  veh 


This  routine  renmves  a  ^whiicle  from  priority  list  zero.  It  moves  the  vehicle  back  to  its 
normal  priority  list. 


Parameters 


Parameter 


veh  id 


lEiT!! 


pointer  to  VehiclelD 


Where  Typedef  Declared 


/simnet/common/include/prot 

ocol/basic.h 


Variable 


list  num 


hash  id 


uared 


Internal  Variables 


e 


inter  to  RVA  ENTRY 


int 


int 


double 


IDT? 

irs 


Where  Tvoedef  Declared 


librva.h 


Standard 


Standard 


Standard 


Error 


PRINT  VID  ERROR 


PRINT  VID  ERROR 


Errors 


Reason  for  Error 


vehicle  is  unknown 


vehicle  is  not  on  onoritv  list  zero 


Function 


rva  find  hash  ent 


zero  uninit  veh 


trv  to  remove  veh 


kinematics  ranoe  sauaret 


rva  aet  prioritv  list 


Calls 


Where  Described 


Section  2.5.12.11.1 


Section  2.5.12.29.2 


Section  2.5.12.18.1 


Section  2.5.8.10.1 


Section  2.5.12.6.1 


Tabk  2L5«275:  rva  unlock  veh  Information. 
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2.5.12.13 


markers.c 

(ysimnet^lease/src/libsTc/librva/maikers.c) 


This  file  includes: 
"stdio-h" 
"math.h" 
"sim_dfns.h" 
"sim_macros.h" 
"sim_types.h" 
"mass_stdc.h" 
"dgi_stg.h" 
"sim_cig_if.h" 
"pro_sim.h" 
"pio_timers.h" 
"assoc.h" 
"timers.h" 
"timers_dfn.h" 
’*libveh.h" 
•*Ubmap.h" 
"UbhulLh" 
"Ubkin.h" 
"rvajoc.h" 
"prior_loc.h" 


Constant  define:  N_MARKER_ENTRIES 


Variable  and  Procedure  Declaradons: 
marker_hash_tables 
process_unknown_marker() 


Minefield  markers  are  set  up  as  static  vehicles,  which  the  CIG  is  able  to  process.  Markers 
are  included  on  the  priority  lists  of  static  vehicles. 


2.S.12.13.1  rva  alloc  marker  table 


This  routine  allocates  memoiy  for  maikers. 


1  Calls  1 

Function 

Where  Described 

rva  alloc  hash  table 

Section  2.5.12.11.1 

Table  2.5-276:  rva_alloc_marker_table  Information. 
2.5.12.13.2  rvajnit_marker_table 
This  routine  initializes  the  maiker  hash  table. 


I  Calls  I 

Function 

Where  Described 

rva  Init  hash  table 

Section  2.5.12.11.2 

Table  2.5-277:  rva  init  marker  table  Information. 
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2.5.12.13.3 


rva_process_markers 


This  routine  processes  a  Vehicle  Appearance  Packet  for  the  minefield  marker  specified  in 
markers. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

markers 

pointer  to  MarkerVariant 

/simnet/common/include/prot 

ocol/basic.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

reaister  int 

Standard 

m 

register  pointer  to 
MarkerOescriptor 

/simnet/common/include/prot 
ocol/p  sim.h 

id 

VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

hash  id 

int 

Standard 

r 

pointer  to  RVA  ENTRY 

librva.h 

1  Calls  1 

Function 

Where  Described 

rva  lookup  hash  table  entry 

Section  2.5.12.11.3 

rva  process  unknown  marker 

Section  2.5.12.13.4 

Table  2.5-278:  rva_process_markers  Information. 
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2.5.12.13.4  rva_process_unkno  wn_ma  rker 


This  routine  creates  a  Vehicle  Appearance  Packet  for  the  minefield  marker  specified  in 
marker,  which  is  not  currently  in  the  RVA  table.  _ 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

marker 

pointer  to  MarkerOescriptor 

/simnet/common/include/prot 
ocol/p  sim.h 

id 

pointer  to  VehiclelO 

/simnet/common/include/prot 

ocol/basic.h 

guises 

pointer  to  VehicieQuises 

/simnet/common/include/prot 

ocol/basic.h 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

hash  id 

int 

Standard 

r 

pointer  to  RVA  ENTRY 

librva.h 

marker_to_world 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

theta 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

rva  insert  hash  table  entry 

Section  2.5.12.11.5 

timers  aet  current  tick 

Section  2.6.3.1.1 

mat  rot  init 

Section  2.6.2.47.1 

d2f  mat  CODY 

Section  2.6.2. 1.1 

Table  2.5-279:  rva_process_unknown_^marker  Information. 


2.5.12.13.5  adjust_markers 

This  routine  does  the  tick  by  tick  adjustments  on  minefield  markers.  For  every  marker  on 
the  static  vehicles  list,  the  routine  checks  to  see  if  the  marker  needs  to  be  added,  deleted, 
changed,  or  removed  from  the  list.  It  also  checks  for  timeouts. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

entry 

register  pointer  to 

HASH  ENTRY 

Section  2.5.12.24,  rva_loc.h 

tmp_veh 

register  pointer  to 

RVA  ENTRY 

librva.h 

i 

register  int 

Standard 

curr  minus  Jimeout 

int 

Standard 

Calls 

Function 

Where  Described 

timers  aet  current  tick 

Section  2.6.3.1 .1 

rva  remove  hash  table  entry 

Section  2.5.12.11.4 

Table  2,5-280:  adjust_markers  Information. 
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2.5.12.14  prior^mnit.c 

(ysimffiaHA%lease/src/libsrc/librva^or_initc) 

This  file  includes: 

"stdio.h" 

”inath.h" 

"simstdio.H"’ 

"sim.dfns.K'"’ 

"sim_inacroKli" 

"siin_typcsJ^* 

"mass_stdcJft*' 

”dgi_stg.h* 

"sin^cigJfJi':" 

"obj_type.h" 

’’cig_bufferJir' 

"rvaJoc.h" 

"priorjoc-tr 

This  file  defines  theft^lowing  constants: 
numNameMa^ 

NUM_AUGMMENTS 

This  file  defines  the  f«>lk>wing  macros: 
vehEnvironMiDsk 
vehClassMaskk 
^dVehicle 
airVehicle 
eiior_exit 
get_non_conan3nent 

This  file  declares: 

obj_name_nH^numNanieMaps] 

veh_alignnienars[NUM_ALIGNMENTS] 

obj_classes[N&i\X_FILTER_CLASSES] 
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2.5.12.14.1 


rva_priority_setup 


This  routine  sets  up  the  priority  list.  The  priority  classes  are  set  up  which  determine  which 
vehicles  will  be  placed  in  which  priority  lists.  Memory  space  is  allocated  for  the  priority 
lists,  then  the  priority  lists  are  initialize  (including  reserved  priority  list  0).  This  routine 
reads  the  object  type,  alignment  (either  "aligned  both",  "aligned  foes",  or  "aligned  fiiend"), 
and  the  minimum  and  maximum  ranges.  Note  that  a  maximum  range  of  -1  signifies  using 
the  maximum  CIG  range.  The  routine  checks  whether  the  vehicles  on  the  priority  list  are 
allowed  in  the  CIG  buffer  (the  default  allows  the  vehicles  in  the  CIG  buffer  for  backward 
compatibility).  This  routine  communicates  with  libfilter  to  determine  the  filter  classes. 
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Errors 

Error 

Reason  for  Error 

error_exit 

-  cam  open  file;  prijdatajile 

>  unexpected  EOF  or  blank  line  getting  max 
range 

-  unexpected  EOF  getting  numjists 

•  unexpected  blank  line  getting  numjists 

•  unexpected  EOL  or  EOF  getting  numbers  of 
vehicles 

-  cam  malloc  add_dynamic_ehjist 

-  unexpected  NULL  line  in  list 

-  bad  vehicle  name 

-  unexpected  blank  line  reading  alignment 

-  invalid  alignment  reading  list 

-  unexpected  range  entries  for  list 

•  bad  max_distance  reading  list 

-  bad  min_distance  reading  list 

-  unexpected  blank  line  reading  filter  class 

-  invalid  filter  class  reading  list 

Calls 

Function 

Where  Described 

filter  set  max  cia  ranae 

Section  2.5.14.8.2 

oet  non  comment 

Macro  defined  in  this  file. 

filter  add  class 

Section  2.5.15.1.1 

FCLOSE 

/simnet/common/include/alobal/simstdio.h 

fitter  verify  classes 

Section  2.5.14  libf liter 

Table  2.5-281:  rva_priority_setup  Information. 
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2.5.12.15  prior_lists.c 

(ysiim»et/release/src/libsrc/librva/i)rior_lists.c) 

This  file  includes: 

"stdio.h" 

"math.h" 

"sines.h" 

"sim_^ns.h" 

"sim_macros.h" 

"sim_types,h" 

"naass_stdc.h" 

"dgi_stg.h" 

’’sim_cig_if.h" 

"basic.h" 

"obj_type.h" 

"pio_timers.h" 

"simstdio.h" 

"UbhuU.h" 

"timers_dfn.h" 

"timers.h" 

’'Ubldn.h" 

"bigwheeLh" 

"rvajoc.h" 

"priorjoc.h" 

This  file  defines  the  following  macros  and  constants: 

CX)LUSION_RADIUS_SQUARED 
SERVICE^RADIUS  SQUARED 
FULL_CIRaJE 
TICKS_PER_MINUTE 
RPM_TO_CIRCLE_PER_TICK 

2.5.12.15.1  check_very_cIose_veh 

If  a  vehicle  is  very  close  (within  1(X)  meters),  this  macro  does  an  exact  range  calulation  and 
checks  to  see  if  the  vehicle  is  within  range  to  be  a  service  vehicle.  If  the  vehicle  is  even 
closer,  then  the  vehicle  is  checked  for  collisions.  The  argument  i_squared,  is  declared  as 
REAL. 
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2.5.12.15.2 


update_and_dead_reckon 


This  routine  is  used  on  "close"  vehicles  (those  which  are  in  the  CIG  buffer).  It  updates  the 
copy  of  the  vehicle's  location  in  the  CIG  buffer  and  then  dead  reckons  the  vehicle. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

veh 

register  pointer  to 

RVA  ENTRY 

libnra.h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

veh  loc 

register  pointer  to  double 

Standard 

CODV 

register  pointer  to  float 

Standard 

veh_copy 

register  pointer  to 

MSG  OTHERVEH  STATE 

/simnet/common/include/cig_i 
f/sim  cig  if.h 

1  Calls  1 

Function 

Where  Described 

map  format  asid 

Section  2.6.11.4.7 

Table  2.5>282:  update_and_dead_reckon  Information. 
2.5.12.15.3  delete  or  timeout 


This  is  a  small  macro  which  deletes  a  vehicle  from  the  hash  table  and  the  priority  list  if  it  is 
marked  for  deletion.  Otherwise,  it  checks  to  see  if  the  vehicle  has  timed  out.  If  the  vehicle 
has  timed  out,  it  is  marked  for  deletion  next  tick. 


1  Calls  1 

Function 

Where  Described 

rva  delete  hash  entry 

Section  2.5.12.11.12 

rva  forget  about  vehicle 

Section  2.5.12.3.1 

Table  2.5-283:  deIete_or_timeout  Information. 

2.5.12.15.4  rotate_rwa_bIades 

This  routine  rotates  the  rotor  and  tail  blades  on  a  helicopter.  Conceptually,  the  en^ne 
speed  is  used  to  determine  how  fast  the  blades  should  be  turning  (assume  that  engine  rpm 
maps  direcdy  ro  blade  speed  with  no  step  down). 

Algorithmically,  the  turretAzimuth  and  gunElevation  fields  in  the  vehicleAppearancePacket 
are  the  most  convenient  places  to  keep  rotation  information.  This  is  especially  true  since 
the  CIG  treats  the  rotor  and  tail  blade  rotations  equivalently  to  turret  azimuth  and  gun 
elevation.  Since  the  turret  and  gun  fields  are  32-bit  unsigned  longs,  the  arithmetic  is  quite 
strightforward  on  machines  that  handle  unsigned  arithmetic  correctly.  On  these  machines, 
the  change  in  rotor  position  is  added  or  subtracted  directly,  and  the  machine  underflows 
and  overflows  automatically,  giving  the  correct  result. 

A  bug  in  the  compiler  used  by  the  Butterfly  machine  causes  the  machine  to  preserve  the 
.sign  bit  whenever  possible.  For  these  machines,  right  shift  both  the  current  and  delta 
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positions  before  doing  the  arithmetic,  and  then  left  shift  back.  While  this  results  in  a  loss 
of  precision,  a  few  bits  are  not  really  important  since  the  positions  have  32  bits  of  precision 
when  converting  the  unsigned  values  into  signs.  The  only  concern  is  how  many  bits  to 
shift.  It  is  best  to  shift  the  smallest  number  of  bits  that  avoid  interfering  with  the  sign  bit  in 
order  to  avoid  loss  of  precision.  It  is  also  desirable  to  set  up  the  shifted  numbers  so 
addition  can  be  done  without  overflowing  into  the  sign  bit,  and  that  subtraction  can  be  done 
without  underflowing  (in  case  underflow  does  not  work  correctly).  To  solve  this,  do  the 
original  shift  right  by  3  bits,  and  then  to  avoid  arithmetic  problems,  set  the  number  3  bit  in 
bo&  the  tunetAzimuth  and  gunElevation.  Setting  this  bit  ensures  no  underflow  on 
subtraction.  If  the  bit  is  not  used  in  a  subtract  (or  if  this  is  an  addition),  then  it  is  shifted  off 
when  left  shifting  back  by  3  bits. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

curr_veh 

register  pointer  to 

RVA  ENTRY 

libtva.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

sine  Dtr 

reoister  pointer  to  float 

Standard 

sgLOtherveh 

pointer  to 

MSG  OTHERVEH  STATE 

/simnet/common/include/cigj 
f/sim  cig  if.h 

sin  cos  index 

int 

Standard 

turn  amount 

register  double 

Standard 

rwajype 

ObjectType 

/simnet/common/include/prot 
ocol/p  sim.h 

circle  frac 

unsigned  long 

Standard 

1  Calls  1 

Function 

Where  Described 

veh  aet  force 

libveh 

SINES  SHIFT  INDEX 

sines. h 

Table  2.5-284: 


rotate  rwa  blades  Information. 
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2.5.12.15.5  adjust_dynamic_vehicles 

This  routine  does  all  the  tick  by  tick  processing  of  dynamic  vehicles.  It  checks  to  see  if 
vehicles  need  to  be  deleted  car  timed  out,  if  new  vehicles  have  arrived,  if  vehicles  have  gone 
out  of  visual  range,  etc.  It  does  the  remove  vehicle  approximation  for  each  vehicle,  and 
up^tes  the  location,  orientation,  and  appearance  of  the  vehicles  in  the  CIG  buffer.  The  last 
priority  list  whose  vehicles  get  into  the  CIG  buffer  is  called  the  cutoff  list  The  cutoff  list  is 
determined  and  commuiucated  to  librilter. 


1  Internal  Variables  I 

Variable 

Where  Tvpedef  Declared 

list  num 

int 

Standard 

but  veh  cnt 

int 

Standard 

extra  veh  cnt 

int 

Standard 

currjist 

register  pointer  to 

PRIORITY  LIST 

Section  2.5.12.17,  prior_loc.h 

curr_veh 

register  pointer  to 

RVA  ENTRY 

librva.h 

prev_veh 

register  pointer  to 

RVA  ENTRY 

librva.h 

cun  minus  timeout 

Int 

Standard 

num  new  dynamics 

int 

Standard 

i 

register  int 

Standard 

1  Calls  1 

Function 

Where  Described 

timers  aet  current  tick 

Section  2.6.3.1.1 

delete  or  timeout 

Section  2.5.12.15.3 

prior  debuQ 

Macro  defined  in  Section  2.5.12.17  prior  loc.h 

is  air  vehicle 

Section  2.6.10.1.1 

is  rwa 

Section  2.6.10.11.1 

rotate  rwa  blades 

Section  2.5.12.15.4 

zero  dead  reckon 

Section  2.5.12.29.5 

update  and  dead  reckon 

Section  2.5.12.15.2 

check  very  close  veh 

Section  2.5.12.15.1 

filter  change  class  bound 

Section  2.5.14.2.1 

delete  veh  from  cig  msg 

Section  2.1.2.2.2.27.1 

rva  forget  about  vehicle 

Section  2.5.12.3.1 

add  veh  to  cig  msg 

Section  2.1.2.2.2.1.1 

Table  2.5-285:  adjust_dynamic_vehicles  Information. 


I 
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2.5.12.15.6  adjust_static_vehicles 

This  routine  does  all  of  the  tick  by  tick  adjustments  on  static  vehicles.  For  every  vehicle  on 
the  static  vehicles  list,  it  checks  to  see  if  the  vehicle  needs  to  be  added,  deleted,  changed,  or 
removed  from  the  list  It  also  checks  for  timeouts  and  resupply  conditions. 


1  Internal  Variables  I 

Variable 

Where  Tyoedef  Declared 

temp_veh 

register  pointer  to 

RVA  ENTRY 

librva.h 

prev_veh 

register  pointer  to 

RVA  ENTRY 

librva.h 

curr  minus  timeout 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

timers  aet  current  tick 

Section  2.6.3.1.1.1 

rva  delete  hash  entry 

Section  2.5.12.11.12 

rva  foraet  about  vehicle 

Section  2.5.12.3.1 

Macro  defined  in  Section  2.5.12.17  prior  loc  h 

1  check  very  close  veh 

Section  2.5.12.15.1 

Table  2.5-286:  adjust_static_vehicles  Information. 

2.5.12.16  priorjoc.c 

(./sirnnet/release/src/libsrc/librva/priorjoc.c) 

This  file  includes: 

"stdio.h" 

"math.h" 

"sim.dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"ptior_loc.h" 

This  file  declares  the  following  variables: 
static_vehs 
sorted_vehicles 
num_priority_lists 
static_list_num 
smooth_cutoff 
cutoff_list_for_rva 
max_vehs_in_buf 
curr_vehs_in_buf 
extra_vehs_allowed 
max_statics_allowed 
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2.5.12.17  priorjoc.h 

(7simnet/release/src/libsrc/librva^rior_Ioc.h) 

This  file  includes: 

’’Ubrva.h" 

"basic.h" 

"Ubfilter.h" 

This  file  defines  the  following  macros  and  constants: 
NUM_TYPES_PER_LIST 
PRIOR_OFnMIZE 
MIN_VEHS_IN_BUF 
prior_debugO 

This  file  defines  the  following  types  and  declares  variables  as  those  types: 
vehj)riority_list  PRIORITY_LIST 

This  file  declares  the  following  external  variables: 
static_vehs 
sorted_vehicles 
num _j)riority_lists 
static_list_num 
sniooth_cutoff 
cutofLlist_for_rva 
max_vehs_in_buf 
cuiT_vehs_in_buf 
extra_vehs_allowed 
max_statics_allowed 

2.5.12.18  prior_rm.c 

(,/sininet/release/src/libsrc/librva/priorjrm.c) 

This  file  includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h'' 

"sim_cig_if.h" 

"rva_loc.h" 

"priorjoc.h" 
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2.5.12.18.1  try_to_reinove_veh 

This  routine  deletes  the  vehicle  specified  by  veh  from  the  priority  list  it  is  on. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

veh 

pointer  to  RVA  ENTRY 

librva.h 

pri  list 

pointer  to  PRIORITY  LIST 

Section  2.5.12.27,  prior  loc.h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

tmp  veh 

pointer  to  RVA  ENTRY 

librva.h 

1  Errors  1 

Error 

Reason  for  Error 

PRINT_VID_ERROR 

PANIC  Standard  couldn’t  delete  veh  from 
prioritv  lists 

Table  2.5-287:  try_to_reinove_veh  Information. 

2.5.12.19  prior_sort.c 

(./simnetfrelease/src/libsrc/librva/prior_sort.c) 

This  file  includes; 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

’’dgi_stg.h" 

"sim_ci^if.h" 

"simstdio.h" 

"libhull.h" 

"rva_loc.h" 

"priorjoc.h" 

This  file  defines  the  following  macros: 
get_range_to_veh 
move_to_new_list 

2.5.12.20  proc_update.c 

(./simnet/rclease/src/libsrc/librva/proc_update.c) 

This  file  includes; 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"sines. h" 

"mass_stdc.h ' 
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"dgi_stg.h" 

"sinL.cig_if.h 

"pro_sim.h" 

"assoc.h" 

"timers.h" 

"Ubveh.h" 

"libmap.h" 

"UbhuU.h" 

”Ubkin.h" 


II 


’’rvajoc.h" 

"prior_loc.h" 


2.5.12.20.1  process_known_static 


This  routine  processes  a  vehicle  appearance  packet  (vap)  from  a  static  vehicle  which  is 
currently  in  Ae  RVA  table.  This  routine  cehcks  to  see  if  the  vehicle's  appearance  has 
changed,  requiring  an  update  to  libmsg. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

r 

pointer  to  RVA  ENTRY 

librva.h 

vap 

pointer  to 

VehicleAppearanceVariant 

/simnet/commorVinclude/prot 
ocol/p sim.h 

Calls 

Function 

Where  Described 

prior  debug 

Macro  defined  in  Section  2.5.12.17  prior  loc.h 

Table  2.5*288:  process_known_static  Information. 


I 
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2.5.12.20.2 


process_unknown_static 


This  routine  processes  a  vehicle  appearance  packet  (vap)  from  a  static  vehicle  which  is  not 
currently  in  the  RVA  table,  places  it  into  the  RVA  Table  and  prioritizes  it. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

r 

pointer  to  RVA  ENTRY 

librva.h 

vap 

pointer  to 

Vehicle  AppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

temp  veh 

pointer  to  RVA  ENTRY 

librva.h 

hash  id 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

rva  add  hash  entry 

Section  2.5.12.11.13 

VEHICLEJDS_EQUAL 

Macro  defined  in 

/simnet/common/include/Qlobal/sim  macros.h 

timers  aet  current  tick 

Section  2.6.3.1.1.1 

prior  debuQ 

Macro  defined  in  Section  2.5.12.17  prior  loc.h 

Table  2.5*289:  process_unknown_static  Information 
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2.5.12.20.3  process_known_dynainic 


This  routine  pnwassses  a  vehicle  appearance  packet  (vap)  from  a  dynamic  vehicle  which  is 
cunently  in  the  R  V A  table.  The  vehicle  is  prioritize.  This  routine  is  not  for  a  vehicle 
which  is  on  prioriity  list  zero. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

r 

pointer  to  RVA  ENTRY 

librva.h 

vap 

pointer  to 

Vehicle  AppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

sin  cos  index 

reqister  int 

Standard 

list 

pointer  to  PRIORITY  LIST 

Section  2.5.12.17,  prior  loc.h 

curr  list 

int 

Standard 

new  list 

int 

Standard 

r  squared 

double 

Standard 

sine  ptr 

reqister  pointer  to  float 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

PRINT  VID  ERRa)R 

PANIC  •  invalid  priority  list  for  vehID 

1  Calls  1 

Function 

Where  Described 

kinematics  ranoe  squared 

Section  2.5.8.10.1 

rva  qet  orioritv  Bs!: 

Section  2.5.12.6.1 

orior  debuq 

Macro  defined  in  Section  2.5.12.17  prior  loc.h 

try  to  remove  vein 

Section  2.5.12.18.1 

is  (wa 

Section  2.6.10.11.1 

fvec  scale 

Section  2.6.2.23 

map  format  askf 

Section  2.6.11.4.7 

veh  qet  force 

Section  2.6.10.6.3 

map  net  to  cio 

Section  2.6.11.5.8 

fmat  copy 

Section  2.6.2.12.1 

SINES  SHIFT  WCilEX 

sines,  h 

rva  forqet  about  vehicle 

Section  2.5.12.3.1 

Tafele  2.5-290:  process  known  dynamic  Information. 
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2.5.12.20.4 


process_unknown_dynamic 


This  routine  processes  a  vehicle  appearance  packet  (v(^)  from  a  dynamic  vehicle  which  is 
not  currently  in  the  RVA  table.  The  vehicle  is  placed  in  the  RVA  table  and  prioritized. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

r 

pointer  to  RVA  ENTRY 

librva.h 

vap 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

list  num 

int 

Standard 

list 

pointer  to  PRIORITY  LIST 

prior  loc.h 

hash  id 

int 

Standard 

r  squared 

double 

Standard 

1  Calls  1 

Function 

Where  Described 

kinematics  ranqe_  squared 

Section  2.5.8.10.1 

rva  qet  oriority  list 

Section  2.5.12.6.1 

prior  debuq 

Macro  defined  in  Section  2.5.12.17  prior,  loc.h 

rva  add  hash  entry 

Section  2.5.12.11.13 

fyec  scale 

Section  2.6.2.23 

timers  qet  current  tick 

Section  2.6.3. 1.1 

Table  2.5*291:  process_unknown_dynamic  Information. 
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2.5.12.20.5  rva_process_update 

This  routine  is  called  by  process_^a_packetO  in  libRcvNet  to  process  a  vehicle 
appearance  packet  It  determines’af  the  vehicle  is  static  or  dynamic,  known  or  unknown,  or 
if  it  is  on  the  special  smoothing  list  (list  zero). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

vap 

pohiHer  to 

VetaicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Internal  Variables  1 

Variable 

Tvme 

Where  Typedef  Declared 

r 

poirlter  to  RVA  ENTRY 

librva.h 

hash  id 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

rva  find  hash  entry 

Section  2.5.12.11.11 

process  unknown  static 

Section  2.5.12.20.2 

process  unknown  dynamic 

Section  2.5.12.20.4 

process  known  static 

Section  2.5.12.20.1 

fvec  scale 

Section  2.6.2.23 

zero  process  dynamic 

Section  2.5.12.29.4 

process  known  dynamic 

Section  2.5.12.20.3 

timers  oet  current  tick 

Section  2.6.3.1.1 

Table  2.5-292t  rva_process_update  Information. 


2.5.12.21  range_sqrd.c 

(./simhetAelease/sirc/libsrc/librva/range_sqrd.c) 

This  file  includes: 

"stdio.h" 

"math.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if,h" 

"rvajoc.h" 

2.5.12.21.1  cig_get_current_range_sqrd 


This  function  gets  the  square  of  tfie  current  range. 


1  Return  Values  I 

Return  Value 

Meaning 

square{max_dgi_range) 

REAL 

The  square  oi  the  current 
range. 

Table  2.5-293:  ci,!.;_get  currenl  range  sqrd  Infurmutiun. 
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2.5 


.12.22  rva_^init.c 

(yiimnet/release/src/libsrc/librva/rva_iniLc) 


This  file  includes; 
"stdio.h" 
"math.h" 
"sim_^ns.h" 
"sim_macros.h 
"sim_types.h" 
"inass_stdc.h" 
"dgi_stg.h" 
"sim_cig_if.h" 
"pro_sim.h” 
"rva_loc.h" 
"priorjoc.h" 


II 


2.5.12.22.1  rvajnit 

This  routine  initializes  the  rva  hash  table,  the  marker  hash  table,  the  entries  in  the  rva  table, 
and  the  priority  lists. 


1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

i 

register  int 

Standard 

this_veh 

register  pointer  to 

HASH  ENTRY 

Section  2.5.12.24,  rva_toc.h 

list 

register  pointer  to 

PRIORITY  LIST 

Section  2.5.12.17,  prior_loc.h 

Calls 

Function 

Where  Described 

rva  init  rva  table 

Section  2.5.12.11.10 

rva  init  marker  table 

Section  2.5.12.13  .2 

Table  2.5>294:  rva  init  Information. 


2.5.12.23  rva_^Ioc.c 

(./simnetAelease/src/libsrc/librva/rva_loc.c) 

This  file  includes: 

”stdio.h" 

"math-h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"pro_sim.h" 

"rva  loc.h" 
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This  file  defines: 

RVA_DEBUG 

This  file  declares: 
rva_debug 
air_vch_listn 
close_veh_listO 
static_veh_listO 
reniove_veh_listD 
chg_veh_list[] 
add_dynamic_veh_list[] 
vehiclelDlirelevant 
num_air_vehs 
num_close_vehs 
close_ctr 
num_static_vehs 
num_to_remove 
num_chg_vehs 
inax_dgi_range 

2.5.12.24  rva_^loc.h 

(./iminet/release/sic/libsrc/librvaAva_loc.h) 

This  file  includes  "librva.h". 

This  file  defines  the  following  constants  and  macros: 
N_HASH_VALUES 
N_HASH_ENTRIES 
PRINT_VID_ERROR 

This  file  defines  the  following  types: 

HASH.TABLE 

HASH.ENTRY 

This  file  declares  the  following  external  variables  and  procedures: 
rva_debug 
icmote_vehicles 
air_veh_listG 
close_veh_list[] 
static_veh_listn 
remove_veh_list[] 
chg_veh_list[] 
num_air_vehs 
num_close_vehs 
num_static_vehs 
num_to_iemove 
num_ch^vehs 
max_dgi_range 

deal_with_possibIe_collision() 
try_ro_remove  vehO 
zero_process_Jynamic() 
zero_dead_reckon() 
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rva_init_hashing() 
rva~alloc_inarker_table() 
rva”init_marker  table() 
rva_alloc_rva_table() 
rva_init_rva  table() 
rva~init”hasli_table() 

2.5.12.25  rva_^setup.c 

(ysimne^lease/src/libsrc/librvaAva_setup.c) 

This  file  includes: 

"stdio.h" 

’'math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

*'mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"pro_sim.h" 

"rvajoc.h" 


2.5.12.25.1  rva_setup 

This  routine  allocates  the  RVA  table  and  Markers  table,  and  calls  rva_priority_setup(). 
Note  that  the  setup  only  happens  once,  while  initializations  may  happeiTany  number  of 
times. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pri  list  file 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

rva  alloc  rva  table 

Section  2.5.12.11.9 

rva  alloc  marker  table 

Section  2.5.12.13.1 

rva  priority  setup 

Section  2.5.12.14.1 

Table  2.5-295:  rva_setup  Information. 


2.5.12.26  show_vehs.c 

(./simnet/release/src/libsrc/librva/show_vehs.c) 

This  file  is  used  for  the  stealth  vehicle  in  order  to  keep  the  vehicle  it  is  attached  to  invisible 
to  the  stealth.  Information  about  the  attached  vehicle  is  not  put  into  the  CIG  buffer. 

This  file  includes: 

"stdio.h" 

"sim_dfns.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"rva  loc.h" 
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•TOiulLh" 

"libkiiLh" 

”pEk»r_loc.h" 

2.5.12  .  1  rva_y  ehicle_is_visible 

This  roudiBe  is  called  to  turn:  a  vehicle  visible. 


1  Parameters  1 

Parameteir 

Where  Tvoedef  Declared 

vehjd 

pointer  to  VehictelD 

/simnet/common/include/prot 

ocol/basic.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

r 

pointer  to  RVA  ENTRY 

librva.h 

list  num  . 

int 

Standard 

hash  id 

int 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

PRINT  VID  ERROR 

vehicle  is  unkown 

1  Calls  1 

Function 

Where  Described 

rva  find  hash  entry 

Section  2.5.12.11.11 

Table  2.5-2J96:  rva_vehiclejs_visible  Information. 


i 
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2.5.12.26.2  rva_vehicle_is_invisible 

This  routine  is  called  to  turn  a  vehicle  invisible.  Note  that  this  vehicle  will  be  maintained  in 
the  RVA  table  forever  (no  matter  what  the  range)  until  it  either  becomes  visible  or  is 
removed  by  timeout.  If  a  static  vehicle  is  made  invisible,  then  the  routine  in  "tell_cig.c’’ 
will  add  the  vehicle  to  the  remove  list. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

vehjd 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

r 

OOintertoRVA  ENTRY 

librva.h 

hash  id 

int 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

PRINT  VID  ERROR 

vehicle  is  unkown 

1  Calls  1 

Function 

Where  Described 

rva  find  hash  entry 

Section  2.5.12.11.11 

delete  veh  from  ciq  msq 

Section  2.1.2.2.2.27.1 

Table  2.5-297:  rva_vehicle_is_in visible  Information. 
2.5.12.26.3  vehicle_is_visible 

This  routine  allows  either  rva_vehicle_is_visible()  or  vehicle_is_visible()  to  be 
used  interchangeably  (for  backwards  compatibility  with  existing  code)7 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

veh 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

Calls 

Function 

Where  Described 

rva  vehicle  is  visible 

Section  2.5.12.26.1 

Table  2.5-298:  vehicle  is  visible  Information. 
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2.5.12.26.4  vehicle_is_invisible 

This  routine  allows  either  rva_vehicle_is_invisible()  or  vehicle_is_invisibie()  to  be 
used  interchangeably  (for  backwards  compatibility  with  existing  code). 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

veh 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

Function _ 

rva  vehicle  is  invisible 


Calls _ 

I  Where  Describe 

Section  2.5.12.26.2 


Table  2.5-299:  vehicle_is_invisible  Information. 

2.5.12.27  tell^cig.c 

(./simnei/release/src/libsrc/librva/tell_cig.c) 

This  file  includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"rtc.h" 

’'libcig.h" 

"rvajoc.h" 

"prior_loc.h" 

This  file  declares  the  following  external  procedures: 
adjust_dynamic_vehicl€s() 
adjust~static_vehicles() 
adjust”markers() 


1208 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.5.12.27.1  rva_telI_cig_about_other_vehicIes 


This  routine  initiates  the  tick  by  tick  processing  by  calling  the  adjust  vehicles  and  markers 
routines.  TTus  routine  communicates  with  the  CIG  buffer  and  reduces  or  increments  the 
number  of  vehicles  in  the  CIG  buffer  if  the  CIG  reports  that  it  cannot  keep  up. 


1  Calls  1 

Function 

Where  Described 

prior  debuQ 

Macro  defined  in  Section  2.5.12.17  prior  loc.h 

rtc  start  time 

Section  2.6.16.1.2 

adjust  dynamic  vehicles 

Section  2.5.12.15.5 

adjust  static  vehicles 

Section  2.5.12.15.6 

adjust  markers 

Section  2.5.12.13.5 

rtc  stop  time 

Section  2.6.16.1.3 

Table  2.5-300:  rva_teII_cig_about_other_vehicIes  Information. 

2.5.12.28  too  many_vehs.c 

(.^imnetJtelease/src/libsrc/librva/too_many_vehs.c) 


This  file  includes: 
"stdio.h" 
"sim_types.h" 
"mass_stdc.h" 
"dgLstg.h" 
"sim_cig_if.h" 
"rvajoc.h" 
"priorjoc.h" 


2.5.12.28.1  cig_too_many_vehicles 

The  CIG  interface  code  calls  this  routine  when  the  CIG  returns  an  overload  message.  The 
number  of  vehicles  that  are  allowed  into  the  buffer  is  decremented  by  2.  This  routine 
applies  only  to  dynamic  vehicles. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

count 

int 

Standard 

Table  2.5-301:  cig_too_many_vehicles  Information. 

2.5.12.29  zero_veh.c 

(./simnet/release/src/libsrc/librva/zero_veh.c) 

These  routines  are  applicable  to  the  Stealth  vehicle  for  smoothing  the  movement  of  the 
attached  vehicle.  These  routines  implement  a  smoothing  algorithm  for  vehicles  which  need 
to  be  dead  reckoned  with  a  very  high  level  of  fidelity.  This  algorithm  is  used  on  vehicles 
which  have  been  locked  into  the  priority  lists  by  having  been  placed  on  priority  list  zero. 

When  a  new  vehicle  appearance  packet  is  received  for  the  vehicle,  the  vehicle  is  dead 
reckoned  forward  by  ^e  number  of  ticks  specified  in  smoothjicks.  Then,  an  alternate 
velocity  vector  for  the  vehicle  is  calculated  which  takes  it  from  its  present  (dead  reckoned) 
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position  to  the  extrapolated  position.  Similarly,  a  rotation  matrix  is  created  which  smoothly 
reorients  die  vehicle  to  its  correct  (as  specified  in  the  new  vehicle  appearance  packet) 
orientation  over  time.  Instead  ot  dead  reckoning  by  adding  the  velocity  vector,  the  alternate 
velocity  is  used  with  a  rotation  update  until  the  number  of  ticks  speicfied  in  smooth  jicks 
have  passed.  Then,  the  velocity  specified  in  the  packet  used  with  no  rotation  updates. 

Note  that  this  is  still  a  rather  expensive  algorithm,  and  should  not  be  run  for  more  than  a 
very  few  vehicles  at  any  one  time.  Currently,  only  one  vehicle  can  be  put  into  list  zero  at  a 
time. 

This  file  includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stg.h" 

"sim_cig_if.h" 

"sines.h" 

"simstdio.h" 

"timers_dfn.h" 

"timers.h" 

"libkin.h" 

"libveh.h" 

"rvajoc.h" 

"priorjoc.h" 

The  following  declarations  are  made: 
spec_dead_reckon 
smooth_ticks 
pos_veloc[3] 
orient_veIoc[3]  [3] 
turret_az_vel 
turret_el_vel 
u-ue_turret_az 
true_turrct_el 

The  following  constants  are  defined: 

MIN_SMCX)TH_TICKS 

DIST_THRESH 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.5.12.29.1 


zero  init  veh 


This  routine  is  called  to  set  the  hash  ID  on  the  zero  priority  list  Currently,  only  one  vehicle 
is  allowed  on  this  list. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

hash  id 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

TRUE 

BOOL 

only  one  vehicle  can  be 
zeroed  at  a  time. 

FALSE 

BOOL 

hash  ID  is  initiated  on  the  zero 
Drioritv  list 

Table  2.5*302:  zero  init  veh  Information. 


2.5.12.29.2  zero  uninit  veh 


This  routine  is  called  to  indicate  that  the  specified  vehicle  has  been  removed  from  the  zero 
priority  list. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

hash,  id 

int 

Standard 

Return  Values 

Return  Value 

Meaning 

TRUE 

BOOL 

invalid  hash  ID 

FALSE 

BOOL 

hash  ID  is  removed  from  the 
zero  orbritv  list 

Table  2.5-303:  zero  uninit  veh  Information. 
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2.5.12.29.3  zero_get_new_velocities 

This  routine  calculates  what  the  temporary  position  and  orientation  velocities  should  be.  It 
writes  new  values  into  all  fields  of  the  smooth  vehicle  structure. 


r  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

r 

pointer  to  RVA  ENTRY 

librva.h 

vap 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/include/prot 

ocol/p.sim.h 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

curr  veloc 

array  3  of  float 

Standard 

reckd  dos 

array  3  of  double 

Standard 

3  by  3  matrix  of  float 

Standard 

delta  orient 

3  by  3  matrix  of  float 

Standard 

mat  Dtr 

array  3  of  float 

Standard 

headina 

float 

Standard 

pitch 

float 

Standard 

roii 

float 

Standard 

turr  az 

float 

Standard 

turr  el 

int 

Standard 

inv_t_sqrd 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

1  Calls  1 

Function 

Where  Described 

timers  qet  current  tick 

Section  2.6.3.1.1 

vec  COPY 

Section  2.6.2.59 

#vec  copy 

Section  2.6.2.26  .1 

Section  2.6.2.12.1 

fmat  transpose 

Section  2.6.2.19.1 

fmat  mat  mul 

Section  2.6.2.14 

fmat  rot  init2 

Section  2.6.2.17.1 

Table  2.5-304:  zero_get_new_velocities  Information. 
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2.5.12.29.4  zero_process_dynamic 

This  routine  is  called  when  a  vehicle  appearance  packet  is  received  from  a  vehicle  on 
priority  list  zero.  After  making  a  call  to  get  new  position  and  orientation  updates,  it  copies 
all  of  Ae  other  information  into  the  CIG  buffer  copy  of  the  vehicle. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

r 

pointer  to  RVA  ENTRY 

librva.h 

vap 

pointer  to 

VehicieAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

reckoned  orient 

3  by  3  matrix  of  float 

Standard 

reckonedjaos 

arrary  3  of  REAL 

/simnet/common/include/glob 
al/sim  types.h 

diff 

array  3  of  REAL 

/simnet/common/include/glob 
al/sim  types.h 

thresh 

REAL 

/simnet/common/inciude/glob 
al/sim  types.h 

reckoned_azimuth 

Angle 

/simnet/common/include/prot 

ocol/basic.h 

reckoned_elevation 

Angle 

/simnet/common/include/prot 

ocol/basic.h 

msg_otherveh 

pointer  to 

MSG  OTHERVEH  STATE 

/simnet/common/include/cigj 
f/sim  cig  if.h 

sine  ptr 

register  pointer  to  float 

Standard 

sin  cos  index 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

vec  sub 

Section  2.6.2.65 

vec  mag3 

/simnet/common/include/global/sim  macros. h 

zero  get  new  velocities 

Section  2.5.12.29.3 

fmat  copy 

Section  2.6.2.12.1 

vec  copy 

Section  2.6.2.59 

map  format  asid 

Section  2.6.11.4.7 

veh  get  force 

Section  2.6.10.6.3 

map  net  to  cig 

Section  2.6.11.5.8 

SINES  SHIFT  INDEX 

sines. h 

Table  2.5-305:  zero_process_dynamics  Information. 
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2.5.12.29.5  zero_dead_reckon 

This  routine  deadscckons  a  vehicle  on  the  zero  priority  list 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

r 

pointer  to  RVA  ENTRY 

librva.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

veh  loc 

pointer  to  float 

Standard 

COPY  loc 

pointer  to  float 

Standard 

tmp 

pointer  to 

MSG  OTHERVEH  STATE 

/simnet/common/include/cig_i 
f/sim  cia  if.h 

saved  alien 

unsigned  char 

Standard 

1  Errors  1 

Error 

Reason  for  Error 

PRINT  VID  ERROR 

Can't  adjust  veh  app  of  invalid  veh  id 

1  Calls  1 

Function 

Where  Described 

d2f  vec  CODY 

Section  2.6.2.2.1 

fmat  CODY 

Section  2.6.2.12.1 

fmat  mat  mul 

Section  2.6.2.14 

fveC  CODY 

Section  2.6.2.26.1 

fvec  add 

Section  2.6.2.25.1 

Talble  2.5-306:  zero_dead_reckon  Information. 
2.5.12.29.6  zero_set_extrapoIation_period 

This  routine  is  used  tto  set  the  number  of  ticks  over  which  the  vehicle  is  restored  from  a 
known  incorrect  posfedon  and  orientation  to  a  predicted  correct  position  and  orientation. 
This  void  procedure  takes  a  single  argument,  num  jicks,  which  is  declared  as  an  int. 
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2.5.13  librva  util 

(^imnet/release/src/libsrc/librva_util  [librva_util]) 

2.5.13.1  get  list.c 

(.^imnetAelease/src/libsrc/librva_util/get_lisLc) 


Includes; 

”stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"p_sim.h" 

"Ubmatrix.h" 

"mass_stdc.h" 

”dgi_stdg.h" 

"sim_cig_if.h" 

"Ubrva.h" 

"Ubrva  util.h" 


2.5.13.1.1  rva_create_output_list 

This  routine  is  a  stub  in  anticipation  of  release  6.6.1  routines. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

inclusionJnO 

pointer  to  function  that  returns 
int 

Standard 

Table  2.5-307:  rva_create_output_list  Information. 


2.5.13.1.2  rva_get__outpuMist 

This  routine  provides  an  interface  to  the  librva  routines  by  getting  either  a  close  vehicles  list 
or  an  air  vehicles  list  from  the  librva  hash  table,  given  the  ^define  input  parameter,  list  id. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

list  id 

int 

Standard 

list 

pointer  to  pointer  to  pointer  to 
VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

num  vehicles 

pointer  to  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

1 

1  int 

the  procedure  was  successful 

1  Calls  1 

Function 

Where  Described 

rva  aet  close  list 

Section  2.5.12.9.1 

rva  aet  air  veh  list 

Section  2.5.12.4.1 

Table  2.5-308:  rva_get_output_Iist  Information. 
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2.5.13.1.3  ini'a_util_get_veh_app_pkt 

This  routine  caills  the  librva  routine,  rva_get_veh_app_pkt(). 


Parameters 


Parameter 


vehicle 


IDTX 


pointer  to  VehiclelD 


Where  Typedef  Declared 


/simnet/common/include/prot 

ocol/basic.h 


Variable 


hash  id 


lEn? 


Internal  Variables 


e 


Where  Typedef  Declared 


Standard 


Return  Value 


rva_get_veh_apRp_pkt 


107!! 


Return  Values 


e 


pointer  to 

VehicleAppearanceVariant 


int 


Meanin 


the  vehicle  appearance  variant 


Vehicle  is  unknown 


Function 


rva  oet  veh  a 


!j!3 


Calls 


Where  Described 


Section  2.5.12.7.1 


Table  2.5-309:  rva_util_get_app_pkt  Information. 
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librva_util.h 

(ysimnetABlease/src/libsrc/librva_util/librva_utiLh) 


Includes: 

"sim_types.h" 

"p_sim.h" 


External  Procedure  Declarations; 

rva_create_output_list() 
rva“get_output  list() 
rva”sinooth_veliicle() 
rva~dont_sinooth_vehicle() 
rva~util_get_veh_app_pkt() 

This  file  contains  function  declarations  and  definitions  used  in  librva_util. 


Vehicles  CSQ 
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2.5.14  Kibniter 

(VsimnetAelease/src/libsrc/Iibfilter  [libfilter]) 

In  an  exercise'  -with  a  large  number  of  simulated  vehicles,  most  VAPs  are  of  no  interest  to  a 
given  simulattor,  because  they  are  not  one  of  the  N  highest  priority  vehicles.  Libfilter 
provides  librvia  with  an  interface  to  download  the  necessary  data  to  the  network  device  to 
discard  unwanted  VAPs  at  the  network  device  level.  This  process  is  called  ffltering. 
Network  filtering  results  in  the  elimination  of  unnecessary  data  transfers  between  the 
network  devicse  and  host  memory,  which  can  be  prohibitively  expensive.  The  Ml  and  M2 
Masscomp  amd  Simnet  Butterfly  machines  all  have  CMC  cards  which  connect  to  the 
netwoilc.  Each.  CMC  card  has  its  own  processor,  and  in  an  effort  to  reduce  the  number  of 
vehicles,  some:  processing  is  offloaded  to  the  CMC  processor  where  out  of  range  vehicles 
will  be  filterecil  out  Two  shared  memoty  degments  allow  data  to  go  back  and  forth 
between  applications  and  host  using  pointers.  The  files  in  this  code  contain  routines  for 
communicatm^g  with  the  program  running  on  the  CMC  card  (except  for  filter.c) 

2.5.14.1  »dd.c 

(./simnet/release/src/libsrc/libfilter/add.c) 

This  file  contains  the  routines  to  specify  the  filter  class.  The  file  includes  "filter_loc.h". 

2.5.15.1.1  filter_add_class 

This  routine  aeSds  a  class  of  vehicles  to  the  filter  list,  for  example,  air  vehicles  beyond  a 
certain  range  will  be  filtered.  The  routine  takes  as  parameters:  class  num  —  the  class 
number,  objjtiass  -  a  pointer  to  the  object  class  being  added,  alignment  (or  alignments)  to 
be  included,  aind  the  range  of  vehicles  in  this  class.  This  routine  returns  -1  if  class _num  is 
out  of  range,  amd  0  otherwise. 


Parameter 


class  num 


obLclass 


alianment 


ranae 


Parameters 


e 


int 


pointer  to 

REMOTE  OBJ  CLASS 


int 


int 


Where  Typedef  Declared 


Standard 


libiilter.h 


Standard 


Standard 


Variable 


numclasses 


Internal  Variables 


e 


reoister  int 


lEiTl 


Where  Typedef  Declared 


Standard 


Return  Valur: 


Ei73 


Return  Values 


Meanin 


rocedure  was  successful 


class  number  is  out  of  range; 
procedure  failed 


Calls 


Function  Where  Described 


DATACOPY  Macro  defined  in  filter  loc.h 


Table  2,5-310’  filter  add  class  Information. 
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2.5.14.2 


bounds.c 

(./simnet/release/src/libsrc/libfilter/bounds.c) 


Includes: 

"filter_loc.h" 


2.5.14.2.1  filter_change_class_bound 

This  routine  is  used  to  change  the  boundary  on  a  filter  class.  It  takes  as  parameters: 
class  num  —  the  class  number,  the  alignment,  and  a  range.  If  the  alignment  is  specified  as 
ALI<jHNED_BOTH,  then  the  new  range  applies  to  both  friend  and  foe  boundaries, 
otherwise,  it  applies  to  the  specified  bound^  only.  The  new  boundaries  are  downloaded 
to  the  CMC  card.  As  with  filter_add_class(),  this  routine  saves  the  new  range  for 
computing  boundaries  when  the  filter  location  changes.  The  routine  returns  -1  if 
class  jtwn  is  out  of  range,  and  0  otherwise. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

class  num 

int 

Standard 

alianment 

int 

Standard 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

box 

register  pointer  to 

BOUND  BOX 

filter_loc.h 

1  Return  Values  1 

Return  Value 

Meaning 

0 

int 

procedure  was  successful 

-1 

int 

class  number  is  out  of  range; 
procedure  failed 

1  Calls  1 

Function 

Where  Described 

DATACOPY 

Macro  defined  in  filter  loc  h 

Table  2.5>311:  niter_change_class_bound  Information. 

2.5.14.3  data.c 

(./simnet/rclease/src/libsrc/libfilter/data.c) 


Includes: 

Tilterjoc.h" 

This  file  defines  all  data  shared  between  the  various  libfilter  functions. 

Variable  Declarations: 

bound_info  -  a  local  image  of  what  will  be  downloaded  to  the  CMC  card. 

card_bound_info  --  a  pointer  to  the  boundjnfo  portion  of  the  CMC  card  memory. 

class_ranges[]  --  contains  the  current  range  for  each  class;  since  this  changes 

infrequently,  it  does  not  need  to  be  passed  around 
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UiosL-info  “  a  pointer  to  the  shared  memory  on  the  host  containing  information 

about  the  different  classes  being  filtered  on. 

fnlterjocadon  -  the  center  of  all  the  bound  boxes,  twice  the  range  on  each  side; 

cuirently  the  z  coordinate  is  ignored. 

22. S. 14.4  dump.c 

(7simnetAelease/src/iibsrc/libfilter/dump.c) 

Uncludes: 

"network.h" 

Tilter_loc.h" 

inds  file  contains  all  definitions  needed  to  display  the  current  filter  information  on  the  CMC 
ccaid. 

22.5.14.4.1  filter_dump_fiiter_info 

TThis  routine  puts  information  about  the  filter  cuirendy  on  the  CMC  card  onto  stdout  The 
PNUMBER_OF_REGISTERS  - 1]  register  (the  last  register)  is  used  for  the  maximum  CIG 
nange  box. 


Vrarlable 


d'sass 


Internal  Variables 


reaister  int 


register  pointer  to 
VEH  LIMITS 


register  pointer  to 
REMOTE  OB  CLASS 


ini 


Where  Tvoedef  Declared 


Standard 


libfilter.h 


libfilter.h 


Standard 


Fi*unctlon 


n(iet_reg_read 


nretwork  get  net  handle 


Calls 


Where  Described 


Section  2.20.2.16.1  See  MCC  CSCI 
document 


Section  2.1.1.3.2.12.1 


Table  2.5>312:  filter_dump_filter_info  Information. 

22.5.14.5  filter.c 

(7simnet/relcase/src/libsrc/libfilter/filter.c) 

Itlncludes: 

"enpif.h" 

"network.h" 

''p_assoc.h" 

"p_sim.h" 

"p_num.h" 

"veh_type.h" 

"Ubfilter.h" 

"hod_to_i.h" 

TThis  file  contains  application  specific  routines  which  will  be  linked  into  the  CMC  ethcrnet 

f'driver  to  filter  packets  on  the  network. 
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Th ,  macro  CHECK_RANGE()  is  defined.  Note  that  this  causes  a  return  of 
FREE_PACKET  if  the  x  and  y  given  are  outside  the  box. 


2.5.14.5.1  do_packet_f  rom_network 


This  routine  gets  called  by  the  CMC  driver  when  a  packet  arrives.  The  routine  decides  if 
the  CMC  caid  should  put  the  packet  into  the  host's  ring  buffer  by  returning 
SEND_PACKET  or  discard  the  packet  by  returning  FfeE_PACKET.  A  set  of  vehicle 
classes  are  downloaded  to  the  card  when  it  is  initialized,  and  boxes  which  describe  the 
acceptable  range  for  vehicles  in  the  classes  are  downloaded  from  the  host  as  necessary. 

Note  that  non-vehicle  appearance  packets  are  accepted  immediately.  Appearance  packets 
are  rejected  if  they  fall  outside  the  maximum  CIG  range.  Vehicle  appearance  packets  are 
only  accepted  if  Ae  vehicle  is  within  the  box  specified  for  its  class  (and  alignment)  or  if  it 
does  not  fall  into  any  specified  class.  Note  that  a  vehicle  may  fall  into  a  class  but  not  have  a 
box  set  for  its  alignment.  In  this  case,  the  routine  continues  to  look  for  a  box  that  the 
vehicle  may  fall  into,  class  is  the  pointer  to  the  current  vehicle  class,  box  is  the  pointer  to 
the  current  test  area,  i  is  the  loop  counter  for  classes,  pdu  x  and  pdu_y  are  the  location  of 
the  vehicle  as  integers.  The  routine  declares  pointers  into  the  various  parts  of  the  packet. 
host  jnfo  is  the  number  of  classes  and  list  of  classes,  bound  irtfo  contains  the  force  id  and 
bounding  boxes. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Dkt 

pointer  to  short 

Standard 

I  internal  Variables  1 

Variable 

Where  Typedef  Declared 

class 

register  pointer  to 

REMOTE  OBJ  CLASS 

libfilter.h 

box 

register  pointer  to 

BOUND  BOX 

filterjoc.h 

hlQh  order  double 

register  long 

Standard 

i 

register  int 

Standard 

vap 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/inciude/prot 
ocol/p  sim.h 

mp 

pointer  to  MarkerVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

Ddu  X 

long 

Standard 

DdU  V 

iong 

Standard 

but 

pointer  to  NetworkPacket 

libnetif 

apdu 

pointer  to  AssociationPDU 

/simnet/common/include/prot 
ocol/p  assoc. h 

spdu 

pointer  to  SimuiationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

host  info 

pointer  to  HOST  INFO 

filter  loc.h 

bound  info 

pointer  to  BOUND  INFO 

filter  loc.h 

veh  iimits 

pointer  to  VEH  LiMITS 

filter  loc.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

SEND  PACKET 

int 

packet  is  sent 

FREE  PACKET 

int 

packet  is  freed;  coordinates 
are  outside  the  range 
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Calls 

Function 

Where  Described 

GET  DATA  PTR 

Macro  defined  in  network.h 

HIGH  ORDER  DOUBLE  TO  INT 

Macro  defined  in  hod  to  i.h 

CHECK  RANGE 

Macro  defined  in  filter.c 

Table  2.5>313:  do_packet_from_network  Information. 
2.5.14.5.2  do_packet_from_host 

This  routine  is  called  everytime  the  CMC  driver  receives  a  packet  from  the  host  The 
routine  determines  if  the  packet  should  be  sent.  SEND_PACKET  is  returned  if  the  packet 
should  be  sent  and  FREE_PACKET  is  returned  if  the  packet  should  be  ignored.  Note  that 
currently  all  packets  from  the  host  are  sent 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

Dkt 

pointer  to  short 

Standard 

1  Return  Values  I 

Return  Value 

Type 

Meanina 

SEND_PACKET 

int 

The  packet  is  placed  into  the 
ring  buffers 

Table  2.5<314:  do_packet_from_host  Information. 

2.5.14.5.3  dojnit 

This  routine  is  called  by  the  CMC  driver  when  the  card  is  initialized  (either  on  a  reboot  or 
when  net_stop()  is  called  followed  by  net_norm()).  host  info  is  the  number  and  list  of 
classes,  bound  info  is  the  force  id  and  bounding  boxes. 


1  Internal  Variables  | 

Variable 

Type 

Where  Typedef  Declared 

host  info 

pointer  to  HOST  INFO 

filter  loc.h 

bound  info 

pointer  to  BOUND  INFO 

filter  loc.h 

Table  2.5-315:  do  init  Information. 


2.5.14.6  force.c 

(./simnetAelease/src/libsrc/libfilter/force.c) 

Includes: 

"filter_loc.h" 

This  file  contains  all  definitions  needed  to  inform  the  CMC  card  of  a  change  in  the  host's 
force  id. 
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2.5.14.6.1  filter_set_force 

This  routine  takes  a  force  id,  force,  and  writes  its  value  to  the  CMC  card  via  the  host  info 
shared  memory  pointer. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

force 

ForcelD 

/simnet/common/include/prot 

ocol/basic.h 

Table  2.5<316:  filter_set_force  Information. 
2.5.14.7  init.c 

(./simnetA’clease/src/libsrcAibfilterAnit.c) 


Includes: 

"network.h" 

"filter_loc.h" 

This  file  contains  all  definitions  needed  to  initialize  filtering  packets  on  the  net. 
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2.5.14.7.1  filterjnit 

This  routine  initializes  the  filter.  The  min  x  for  undefined  bound  boxes  and  num_classes 
start  at  zero,  and  card  bound  ittfo  and  host  irfo  get  initialized.  This  routine  must  be  called 
AFTER  network_init().  This  routine  returns  -1  on  failure,  and  0  otherwise. 


Parameter 


handle 


IEI7!I 


Parameters 


Where  Typedef  Declared 


Standard 


Variable 


class  num 


range 


hb  size 


IDT! 


Internal  Variables 


e 


recister  int 


reaister  int 


register  pointer  to 
CLASS  RANGES 


REMOTE  OBJ  CLASS 


register  pointer  to 
VEH  LIMITS 


int 


Where  Typedef  Declared 


Standard 


Standard 


filter_loc.h 


libfilter.h 


filterjoc.h 


Standard 


Return  Value 


DTI 


Return  Values 


Meanin 


rocedure  was  successful 


rocedure  failed 


Error 


rror 


Errors 


Reason  for  Error 


filter  hostbuf  failure 


Function 


net  hostbuf  info 


DATA  COPY 


net  red  write 


Calls 


Where  Described 


Section  2.20.2.6.1  MCC  CSCI  document 


Macro  defined  in  filter  loc.h 


Section  2.20.2.16.2 


Table  2.5-317:  filter  init  Information. 
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2.5.14.8  location.c 

(./simnetAelease/sic/libsrc/libfilter/location.c) 

Includes: 

"filterjoc.h" 

This  file  contains  all  definitions  needed  change  the  location  around  which  classes  are 
filtered. 


Variable  Declarations: 

filter_threshold  —  rather  than  downloading  new  boxes  to  the  card  every  time 
the  location  changes  slightly,  a  threshold  is  defined.  New 
bound  boxes  arc  download^  to  the  CMC  card  only  when 
the  location  has  changed  in  either  the  x  or  y  direction  by  the 
threshold  amount  The  threshold  is  intially  set  for  100 
meters,  but  can  be  changed  dynamically  using 
filter_set_filter_threshold(). 

max_cig_range  -  Before  checking  individual  classes  for  inclusion  in  a 

bounding  box,  every  vehicle  appearance  packet  is  tested 
against  a  single  maximum,  typically  the  maximum  range  at 
which  the  CIG  can  handle  vehicles.  This  is  initially  set  at 
3500  meters,  but  can  be  changed  dynamically. 


2.5.14.8.1  fiIter_set_filter_threshold 

This  routine  sets  the  filter  threshold  to  the  value  of  the  input  parameter  threshold. 

2.5.14.8.2  filter_set_max_cig_range 
This  routine  sets  the  maximum  CIG  range. 


Parameter 


lETni 


Parameters 


Where  Typedef  Declared 


Standard 


Variable 


box 


Internal  Variables 


register  pointer  to 
BOUND  BOX 


Where  Typedef  Declared 


filter  loc.h 


Function 


DATACOPY 


Calls 


Where  Described 


Macro  defined  in  filter  loc.h 


Table  2.5-318:  filter_set_inax_cig_range  Information. 
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2.5.15  libimpacts 

(ysimnet/release/sic/libsic/libimpacts  [libimpacts]) 

One  CSU,  libimpacts  provides  routines  for  managing  impact  information  received  from  the 

network.  Hme-delay^  impacts  are  scheduled  and  executed  hrom  this  module.  Libimpacts 

also  contains  functionality  to  inform  libmsg  of  impacts  to  be  displayed  by  the  CIG. 

2.5.15.1  impacts.c 

(./simnet/release/src/libsrc/libimpactsAmpacts.c) 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h" 

''sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"libsound.h" 

''libsound_dfn.h" 

"libmap.h" 

"libimps.h" 

This  file  defines  the  structure  type  IMPACT  as  follows: 

ammo_type  -  the  type  of  ammo  round 

imp_type  -  the  impact  type  (as  defined  in  2.5.15.2  libimps.h) 

loc  "  where  the  impact  occurred 

delay  -  the  delay  before  impacting  the  ground  (for  indirect  fire) 

r_2  -  the  range  squared 

last  -  the  previous  element  in  the  linked  impact  list 

next  "  the  next  element  in  the  linked  impact  list 

Variable  and  Procedure  Declarations: 
impact_array[MAX_EFF] 
impact_free[MAX_IFF] 
impact_list_start 
impact_free_index 
impacts_debug 
impact_get_element() 
impacts_free_element() 

2.5.15.1.1  impacts_init 

This  routine  initializes  the  impacts  lists. 

Internal  Variables 

Variable  [Type  [Where  Tvpedef  Declare'd" 

i  int  Standard 

Table  2.5-319:  impactsjnit  Information. 
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2.5.15.1.2 


iinpacts_tell_cig_about_impacts 


This  routine  contains  the  linked  impact  lists  with  the  associated  delays.  This  routine 
handles  the  impact  delay  timing.  The  CIG  and  sound  systems  are  notified  of  the  imp_type, 
ammo_type,  and  r_2  elements  of  the  impact  structure  parameter,  qe,  in  order  to  produce  the 
proper  effects  and  sounds.  Once  the  CIG  and  sound  systems  have  been  notified  the 
element  is  freed  (note  that  the  informadon  stored  in  qe  is  still  valid,  it  has  just  been  taken 
out  of  the  queued  effects  list  and  put  on  the  hnee  list). 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

ae 

pointer  to  IMPACT 

impacts.c 

unique  identilier 

int 

Standard 

i 

int 

Standard 

cigjoc 

R4P3D 

/simnet/common/inciude/glob 
al/dqi  stdq.h 

1  Calls  1 

Function 

Where  Described 

mao  qet  burst  around  from  ammo  entry 

Section  2.6.11.2.4 

ciq  msq  prepend  show  effect 

Section  2.1.2.2.2.96.1 

sound  of  .weapons  impact 

Section  2. 1.3. 1.1 

map  oet  burst  air  from  ammo  entry 

Section  2.6.11.2.5 

map  qet  burst  armor  from  ammo  entry 

Section  2.6.11.2.6 

map  qet  burst  wood  from  ammo  entry 

Section  2.6.11.2.7 

map  qet  burst  other  from  ammo  entry 

Section  2.6.11.2.8 

map_set_muzzleJlash_me_from_ammo_ 

entry 

Section  2.6.11.2.10 

map_get_muzzieJiash_otherJrom_ammo_ 

entry 

Section  2.6.11.2.11 

impacts  free  element 

Section  2.5.15.1.5 

Table  2.5-320:  impacts_teII_cig_about_impacts  Information. 
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2.5.15.1.3  impacts_queue_effect 


This  routine  builds  the  impact  structure  from  the  input  parameters,  ammo  type,  impjype, 
loc,  delay,  and  r_2,  and  then  places  the  structure  into  the  effects  queue. 


1  Parameters  1 

1  Parameter 

Where  Tvoedef  Declared 

int 

Standard 

int 

Standard 

loc 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

delay 

int 

Standard 

r_2 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

cia  aet  current  ranae  sqrd 

Section  2.5.12.21.1 

impacts  aet  element 

Section  2.5.14.1.4 

Table  2.5-321:  impacts_queue_effect  Information. 
2.5.15.1.4  impacts_get_element 


This  routine  tries  to  get  a  free  pointer  to  an  element  in  the  impact  list.  If  the  pointer  is 
unavailable,  the  routine  returns  FALSE.  If  the  pointer  is  av^able,  the  routine  returns 
TRUE  and  puts  an  empty  element  at  the  beginning  of  the  impact  list. 


1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

int 

pointer  to  element  is  available 

FALSE 

int 

pointer  is  unavailable 

Table  2.5-322:  impacts_get_element  Information. 
2.5.15.1.5  inipacts_free_element 

This  routine  puts  the  element,  element,  back  on  the  free  list  when  complete. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

element 

pointer  to  IMPACT 

impact  .c 

Table  2.5-323:  impacts_free_element  Information. 
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2.5.15.2  libimps.h 
Includes: 

Defines  the  impact  types  as  follows: 


ivViVAtiiiriv: 


IMPACr_NO_IMPACT 

IMPACT.GROUND 

IMPACT-AIR 

IMPACr_ARMOR 

IMPACr_WOOD 

IMPACT  OTHER 

IMPACT_US 

IMPACT_MUZZLE_FLASH_ME 

IMPACT_MUZZLE_FLASH_OTHER 


IMPACT_NO  SOUND_RANGE 


Procedure  Declarations: 
impacts_init() 

impacts~tell_cig_about_impacts() 

impacts_que"ue_effect()~ 
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2.5.16  libappr 

(yamnctAclease/src/libsic/libapp  [libapp]) 

The  simulation  hostpeasnodically  infomis  other  entities  on  the  network  of  its  cunent 
location,  orientation,  amd  appearance.  It  uses  routines  in  libapp  to  determine,  each  frame,  if 
it  necess^  to  place  ax  update  onto  the  network.  Libapp  checks  for  changes  in  appearance, 
changes  in  position  arcsdentation  which  deviate  from  the  dead  reckoned  model  of  the 
vehicle,  or  time-out  M  the  vehicle's  appearance  has  changed,  or  an  update  has  not  been 
sent  in  the  last  5  secoiula,  one  will  be  generated.  If  an  up^te  is  to  be  sent,  libapp  cdls 
routines  in  "ml_netwci»^c",  ‘'ni2_network.c",  or  "m2_tracks.c"  to  fill  in  vehicle  specific 
fields.  Routines  ase  called  in  ml_tracks.c  to  determine  what  size  dust  cloud,  if  any,  should 
be  reported. 

2.5.16.1  Iibapp.bi 


This  file  defines  tiie  innerface  to  the  libapp  library  of  vehicle  appearance  related  software. 


VehicleAppearance  typedef  consists  of  the  vehicle’s  appearance  at  a  moment  in  time: 


tune 

vehicIeClass 

s^pearance 

rotation 

location 

velocity 

tuiretAzimuth 

gunElevation 


—  the  particular  moment,  in  seconds,  of  the  appearance 

—  class  of  vehicle 

—  type  of  vehicle  and  appearance 

-  pointer  to  rotation  matrix 

-  pointer  to  location 

-  pointer  to  velocity  vector 

—  turret/hull  orientation 

-  gunAurret  elevation 


DiscrepanceThreshol'chs  typedef  applied  to  a  class  of  vehicles  consists  of: 


locationThresb^  3] 
rotationThrcsh 
tumetAzimuthT^iresh 
gunElevationTIja«sh 


“  location  threshold 
“  rotation  angle  about  any  axis 
“  turret  rotation  angle 
-  gun  elevation  angle 


Macro  and  constant  delfines: 


SIMNET_TO_RADIANS_FACTOR 

simnet_angle_to_radians() 

radians_to_simK»et_angleO 

Declarations  of  library  routines: 

ReadDiscrepRancyThresholdsO 

PrepareDiscrepancyThresholdsO 

Appearance!!?)  iscrepancyExceedsThreshoIdsO 

cIear_monit«»r_variabIes() 

get_rea  son_t:xine( ) 

get_reason_japp() 

get~reason_t.u  r_azi( ) 

get_reason~fiun  elev() 

get~reason_l  ocQ" 

get~reason_rot() 
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read.c 


This  file  contains  code  for  reading  a  file  of  discrepancy  thresholds.  The  tile  of  threshold 
values  contains  the  threshold  parameters  which,  if  exceeded,  determine  whether  a 
VehicleAppearance  Packet  is  sent  to  the  network. 

The  format  of  a  file  of  threshold  values  is: 


dimensions  <width>  <length>  <height> 
location  <location  threshold  in  percent  of  vehicle  dimension> 

rotation  crotadon  threshold  in  deg^s> 
turret-azimuth  <tuiret  azimuth  threshold  in  degrees> 
gun-elevation  <gun  elevation  threshold  in  degrees> 

Includes: 

"stdio.h" 

"simstdio.h" 

"libapp.h" 

Static  variable  declarations: 
filename 
file 

External  procedure  declarations: 

ReadThresholdO 
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2.5.16.2.1  ReadDiscrepancyThresholds 

This  routine  reads  a  set  of  thresholds  from  an  ASCII  file.  The  caller  provides  the  name  of 
the  file,//iflme,  and  storage  for  the  thresholds,  thresholds.  The  routine  returns  1  if 
successful,  and  0  otherwise. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

fname 

pointer  to  char 

Standard 

thresholds 

pointer  to 

DiscrepancyThresholds 

iibapp.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

dimensions 

array  3  of  double 

Standard 

location 

array  3  of  double 

Standard 

rotation 

double 

Standard 

turretAzimuth 

double 

Standard 

OunElevation 

double 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

0 

int 

procedure  failed 

1 

int 

procedure  was  successful 

I  Calls  I 

Function 

Where  Described 

ReadThreshold 

Section  2.5.16.2.2 

PreoareDiscreoancyThreshold 

Section  2.5.16.3.1 

Table  2.5*324:  ReadDiscrepancyThresholds  Information. 


1232 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.5.16.2.2 


ReadThreshold 


This  routine  is  used  to  parse  a  single  threshold  parameter. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

format 

pointer  to  char 

Standard 

number 

int 

Standard 

valuet 

pointer  to  double 

Standard 

value2 

pointer  to  double 

Standard 

values 

pointer  to  double 

Standard 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

buffer 

array  100  of  char 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

0 

int 

procedure  failed 

1 

int 

procedure  was  successful 

I  Errors  I 

Error 

Reason  for  Error 

stderr 

Missing  parameter  in  file 

Table  2.5*325:  ReadThreshold  Information. 

2.5.16.3  thresh.c 

This  file  contains  code  for  measuring  the  discrepancy  between  two  versions  of  a  vehicle's 
appearance,  and  testing  that  discrepancy  against  a  set  of  thresholds.  The  librva  location  and 
orientation  approximations  are  compared  to  the  vehicle's  actual  location  and  orientation.  If 
die  variance  between  the  two  exceeds  the  discrepency  threshold  values,  a 
VehicleAppearance  Packet  is  sent. 

Includes: 

"math.h" 

"sim_dfns.h" 

"pro_sim.h" 

"pro_timers.h" 

"libapp.h" 


Defines: 

register 

Declarations  for  monitoring  threshold  discrepancies: 
reson_time 
reson_app 
reason_tur_azi 
reason_gun_elev 
reason_loc[3] 
reason_rot 
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2.5.16.3.1  PreparePiscrepancyTh  reshold 

This  routine  precomputes  certain  values  associated  with  a  set  of  thresholds. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

thresholds 

register  pointer 
DiscrepancvThresholds 

libapp.h 

dimensions 

array  3  of  double 

Standard 

location 

array  3  of  double 

Standard 

rotation 

double 

Standard 

turretAzimuth 

double 

Standard 

gunElevation 

double 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

register  int 

Standard 

1  Calls  1 

Function 

Where  Described  1 

radians  to  simnet  angle 

Table  2.5>326.:  PrepareDiscrepancyThreshold  Information. 
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2.5.16.3.2 


AppearanceDIscrepancyExceedsThresholds 


This  routine  compares  two  descriptions  of  a  vehicle's  appearance,  a  dead  reckoned  location 
and  an  exact  location,  to  determine  whether  they  differ  by  more  than  threshold  amounts. 
The  routine  returns  1  if  an  update  must  be  sent,  and  0  otherwise.  An  update  is  sent  because 
either 


1 .  Five  seconds  have  elapsed  since  the  last  update. 

2 .  Any  appearance  modifier  bits  have  chang^. 

3 .  The  turret  azimuth  discrepancy  exceeds  die  threshold. 

4.  The  gun  elevation  discrepancy  exceeds  the  threshold. 

5 .  The  difference  between  the  current  location  and  the  dead  reckoned  location 
exceeds  the  threshold. 

6.  The  vehicle  rotation  discrepancy  exceeds  the  threshold. 


Parameters  are  represented  as  follows; 


thresholds  - 
lastUpdate  - 
currentApp  - 
dT 


A  pointer  to  the  thresholds  for  the  vehicle  class. 

A  pointer  to  the  last  appearance  broadcast. 

A  pointer  to  the  current  VAP. 

The  number  of  seconds  since  the  last  PDU  was  sent. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

thresholds 

pointer  to 

DiscreoancvThresholds 

libapp.h 

lastUpdate 

register  pointer  to 

Vehicle  AppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

currentApp 

register  pointer  to 

Vehicle  AppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

dT 

double 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

row 

reaister  pointer  to  float 

Standard 

disc 

register  double 

Standard 

I 

Standard 

thresh 

array  of  double 

Standard 

Dosition 

array  of  3  doubles 

Standard 

old  rot 

pointer  to  float 

Standard 

new  rot 

pointer  to  float 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

the  dead  reckoned  location 
may  be  used 

1 

int 

an  update  must  be  send  with 
the  exact  location 

Table  2.5-327:  AppearanceDisrepancyExceedsThresholds  Information. 


2.5.16.3.3 


clear  monitor  variables 
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'IThis  routine  sets  the  monitor  variables  to  0. 

22.5.16.3.4  get_reason_time 

This  routine  returns  the  number  of  times  an  update  was  sent  due  a  time  discrepancy. 


1  Return  Values  1 

neturn  Value 

Meaning 

rreasonjime 

unsigned  long 

the  number  of  times  an  update 
was  sent  due  to  a  time 
discrepancy 

Table  2.5>328:  get_reason_time  Information. 

2.5.16.3.5  get_reason_app 

TTiis  routine  returns  the  number  of  times  an  update  was  sent  due  to  any  appearance  modifier 
blits  discrepancy. 


1  Return  Values  1 

Return  Value 

Meaning 

r(eason_app 

unsigned  long 

the  number  of  times  an  update 
was  sent  to  to  an  appearance 
discrepancy 

Table  2.5-329:  get_reason_app  Information. 
2.5.16.3.6  get_reason_tur_azi 

This  routine  returns  the  number  of  times  an  update  was  sent  due  to  a  turret  azimuth 
cdiscrepancy. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

iTeason_tur_azi 

unsigned  long 

the  number  of  times  an  update 
was  sent  due  to  a  turret 
azimuth  discrepancy 

Table  2.5-330:  get_reason_tur_azi  Information. 
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2.5.16.3.7  get_reason_gun_elev 

This  routine  returns  the  number  of  times  an  update  was  sent  due  to  a  gun  elevation 
discrepancy. 


1  Return  Values  1 

Return  Value 

Meaning 

reason jun_elev 

unsigned  long 

the  number  of  times  an  update 
was  sent  due  to  a  gun 
elevation  discrepancy 

Table  2.5-331:  get_reason_gun_elev  Information. 

2.5.16.3.8  get_reason_loc 

This  routine  returns  the  number  of  times  an  update  was  sent  due  to  a  location  discrepancy. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

reasonjoc 

pointer  to  unsigned  long 

the  number  of  times  an  update 
was  sent  due  to  a  location 
discrepancy 

Table  2.5-332:  get_reason_loc  Information. 

2.5.16.3.5  get_reason_rot 

This  routine  returns  the  number  of  times  an  update  was  sent  due  to  a  rotation  discrepancy. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

reason_rot 

unsigned  long 

the  number  of  times  an  update 
was  sent  due  to  a  rotation 
discrepancy 

Table  2.5-333:  get_reason_rot  Information. 

2.5.16.3.6  print_reasons 

This  routine  prints  the  reasons  for  trasmitting  packets.  This  routine  is  used  for  debugging 
purposes. 
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2.5.17  libnear 

(ysimneiAclease/src/vehicle/libsrc/libnear  [libnear]) 

Libnear  is  a  utility  library  used  by  libmissile  which  contains  routines  which  find  the  closest 
vehicle  to  a  given  point  or  vector.  The  library  keeps  track  of  the  closest  vehicle  from  tick  to 
tick  and  attempts  to  stay  locked  on  to  that  vehicle  if  possible. 

2.5.17.1  near  point.c 

(ysimnet^lease/src/vehicle/libsrc/libnear/near_pointc) 

Includes: 

"stdio.h" 

*'sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"Ubmatrix.h" 

"p_sim.h" 

"Ubrva_utU.h" 

"libnear.h" 
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2.5.17.1.1  near_get_next_veh_near_point 


This  routine  returns  the  next  vehicle  from  the  specified  RVA  list  (yehjistjd),  counting 
from  index,  which  is  within  range  (dist_2)  of  the  given  point  (point).  Index  is  modified. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

veh  .list  id 

int 

Standard 

point 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

dist_2 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

index 

pointer  to  int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

vehicles 

pointer  to  pointer  to 
VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

num  of  veh 

int 

Standard 

delta 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Return  Values  1 

Return  Value 

Meaning 

vehicles[*index] 

pointer  to 

VehicleAppearanceVariant 

the  next  vehicle  from  the  RVA 
list  within  the  oiven  range 

0 

pointer  to 

VehicleAppearanceVariant 

either  no  vehicles  are  on  the 
RVA  output  list  or  no  vehicle  is 
within  the  given  range 

1  Calls  1 

Function 

Where  Described 

rva  oet  output  list 

Section  2.5.13.1.2 

vec  sub 

Section  2.6.2.65.1 

vec  dot  prod 

Section  2.6.2.54.1 

Table  2.5-334;  near_get_next_veh_near_point  Information. 
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2.5.17.1.2  near_get_veh_if_stilI_near_point 

This  routine  returns  the  given  vehicle  (vehicle  Jd)  if  it  is  within  range  (dist_2)  of  the 
specified  point  (point). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

vehicle  id 

pointer  to  VehiclelD 

basic.h 

point 

VECTOR 

/simnet/common/include/glob 
al/sim  types. h 

disl_2 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

vehicle 

VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

delta 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

1  Return  Values  1 

Return  Value 

Meaning 

NULL 

pointer  to 

VehicleAppearanceVariant 

the  vehicle  is  not  within  range 
of  the  aiven  point 

vehicle 

pointer  to 

VehicleAppearanceVariant 

the  vehicle  is  within  range  of 
the  qiven  point 

1  Calls  1 

Function 

Where  Described 

rva  util  qet  veh  app  pkt 

Section  2.5.13.1.3 

vec  sub 

Section  2.6.2.65.1 

vec  dot  prod 

Section  2.6.2.54.1 

Table  2.5-335:  near_get_vehJf_stin_near_point  Information. 
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2.5.17.1.3 


near_get_veh_cIosest_to_point 


This  routine  finds  the  vehicle  on  the  RVA  ouput  list  (yehjistjd),  starting  at  index,  which 
is  closest  to  the  given  point  (point). 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

veh  list  id 

int 

Standard 

point 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

dist_2 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

result 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

index 

int 

Standard 

vehicles 

pointer  to  pointer  to 
VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

num  of  veh 

int 

Standard 

delta 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

current_dist 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

min_dist 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

min  index 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

NULL 

pointer  to 

VehicleAppearanceVariant 

no  vehicles  on  the  RVA 
output  list 

vehicles[minjndex] 

pointer  to 

VehicleAppearanceVariant 

the  closest  vehicle  to  the 

Qiven  point 

1  Calls  1 

Function 

Where  Described 

rva  aet  output  list 

Section  2.5.13.1.2 

vec  sub 

Section  2.6.2.65.1 

vec  dot  prod 

Section  2.6.2.54.1 

Table  2.5-336: 


near_get_veh_cIosest_to_point  Information. 
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2 . 5*17 .1.4  near_get_prelerred_veh_near_point 

Given;  t&at  we  have  a  vehicle  fyehjd)  that  was  near  the  point  during  the  last  frame,  this 
routine  tests  to  see  if  this  vehide  is  sdll  close  to  the  given  point  by  calling  the  routine 
near  gict  veh_if^still_near_paint().  If  the  vehicle  is  still  within  the  given  range  of 
the  p^t,  that  chicle  is  returned.  If  the  vehicle  is  out  of  range,  the  routine  calls 
near  get  veh  closest  to  pointO  to  get  the  current  closest  vehicle  off  the  RVA  output 
list.  ^  ” 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

vehjd. 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

veh  list  id 

iit 

Standard 

point 

VECTOR 

/simnet/common/include/glob 
al/sim  types. h 

dist_2 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

result  1 

pointer  to 

VebScleADpearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Return  Values  1 

Return  Value  j 

Meaning 

result 

pointer  to 

VebiicleAppearanceVariant 

either  resu/f  =  the  vehicle  that 
was  closest  to  the  point  last 
frame,  or  result  =  the  current 
closest  vehicle  to  the  point 

1  Calls  1 

Function 

Where  Described 

near  ae't  veh  if  still  near  point 

Section  2.5.17.1.2 

near  aet  veh  closest  to  point 

Section  2.5.17.1.3 

Table  2.5-337;  nearjget_preferred_veh_near_point  Information. 

2.5.17.2  near  vector.c 

(ysimnet/rclease/src/^hicle/libsrcAibnear/near_vector.c) 


Includes: 

"stdio.h" 

^'sini_types.h" 

"sim_dfns,h" 

"sim_macros.h 

"librnatrix.h" 

"p_sim.h" 

"librva„util.h" 

"libnear.h" 


f  I 
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2.5.17.2.1  near_get_next_veh_near_vector 

This  routine  returns  the  next  vehicle  from  the  specified  RVA  list  (yeh  list  id)  whose  vector 
is  within  angular  range  (cos_2)  of  the  given  vector  (yec). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

veh  list  id 

int 

Standard 

loc 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

vec 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

cos_2 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

index 

pointer  to  int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

vehicles 

pointer  to  pointer  to 
VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

num  of  veh 

int 

Standard 

delta 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

d_prod 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

pointer  to 

VehicleAppearanceVariant 

the  next  vehicle  from  the  RVA 
output  list  within  the  given 
range 

vehicles[*index] 

pointer  to 

VehicleAppearanceVariant 

either  no  vehicles  are  on  the 
RVA  output  list  or  no  vehicle  is 
within  the  given  range 

1  Calls  1 

Function 

Where  Described 

rva  aet  output  list 

Section  2.5.13.1.2 

vec  sub 

Section  2.6.2.65.1 

vec  dot  prod 

Section  2.6.2.54.1 

Table  2.5>338:  near_get_next__veh_near_vector  Information. 
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2.5.17.2.2  near_get_veh_if_stiIl_near_vector 

This  routine  returns  die  given  vehicle  (yehjd)  if  its  vector  is  within  angular  range  (cos_2) 
of  the  specified  va:tor  (^ec). 


Parameter 


veh  id 


Parameters 


C0S_2 


ID71X 


pointer  to  vehiclelO 


VECTOR 


VECTOR 


REAL 


Where  Tvoedef  Declared 


/simnet/common/include/prot 

ocol/basic.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


/simnet/common/include/glob 
al/sim  tvpes.h 


Variable 


vehicle 


lEtTil 


Internal  Variables 


e 


pointer  to 

VehicleAppearanceVariant 


VECTOR 


Where  Tvoedef  Declared 


/simnet/common/include/prot 
ocol/p  sim.h 


/simnet/common/mclude/glob 
al/sim  tvoes.h 


Return  Value 


vehicle 


IE171! 


Return  Values 


e 


pointer  to 

VehicleAppearanceVariant 


pointer  to 

VehicleAppearanceVariant 


Meanin 


the  vehicle  vector  is  not  within 
range  of  the  given  vector 


the  vehicle  vector  is  within 
range  of  the  given  vector 


Function 


rva  util  get  veh  a 


vec  sub 


vec  dot  prod 


Calls 


Where  Described 


Section  2.5.13.1.3 


Section  2.6.2.65.1 


Section  2.6.2.54.1 


Table  2.5-339?:  near_get_veh_if_stiII_near_vector  Information. 
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2.5.17.2.3  near_get_veh_cIosest_to_vector 

This  routine  finds  the  vehicle  on  the  RVA  ouput  list  (vehjistjd)  whose  vector  is  closest  to 
the  given  vector  (vec). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

veh  list  id 

int 

Standard 

loc 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

vec 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

cos_2 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  internal  Variables  1 

Variable 

Where  Typedef  Declared 

vehicles 

pointer  to  pointer  to 
VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

num  of  veh 

int 

Standard 

delta 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

d_prod 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

current_cos 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

min_cos 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

min  index 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

0 

pointer  to 

VehicleAppearanceVariant 

no  vehicles  on  the  RVA 
output  list 

vehicles[minjndex] 

pointer  to 

VehicleAppearanceVariant 

the  closest  vehicle  to  the 
given  vector 

1  Calls  1 

Function 

Where  Described 

rva  aet  output  list 

Section  2.5.13.1.2 

vec  sub 

Section  2.6.2.65.1 

vec  dot  prod 

Section  2.6.2.54.1 

Table  2.5-340:  near_get_veh_cIosest_to_vector  Information. 
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2 . 5 . 1 7 . 2. 41  near_get_preferred_veh_near_vector 

Given  that  wie  have  a  vehicle  (yeh  jd)  whose  vector  was  near  the  given  vector  during  the 
last  frame,  thus  routine  tests  to  see  if  this  vehicle  is  still  near  o  the  given  vector  by  calling 
the  routine  iftear_get_veh  if_stiII_near_vector().  If  the  vehicle's  vector  is  still  within 
the  given  ang^ular  range  of  tReliverTvector,  that  vehicle  is  returned.  If  the  vehicle  is  out  of 
range,  the  romtine  calls  near_get_veh_cIosest_to_vector()  to  get  the  current  closest 
vehicle  off  tine  RVA  output  list  ”  ” 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

vehjd 

pointer  to  VehiclelD 

/simnet/common/inciude/prot 

ocol/basic.h 

veh  list  id 

int 

Standard 

loc 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

vec 

VECTOR 

/simnet/common/include/glob 
al/sim_  tvpes.h 

cos_2 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

result 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Return  Values  1 

Return  Valu<e 

Meanina 

result 

pointer  to 

VehicleAppearanceVariant 

either  resu/t  =  the  vehicle  that 
was  closest  to  the  vector  last 
frame,  or  result  =  the  current 
closest  vehicle  to  the  vector 

1  Calls  1 

Function 

Where  Described 

near  net  veh  if  still  near  vector 

Section  2.5.17.2.2 

near  aet  veh  closest  to-vector 

Section  2.5.17.2.3 

Table  2.5-341: 


near_get_preferred_veh_near_vector  Information. 
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2.5.18  librotate 

(7simnet/release/sic/vehicle/libsrc/IibtDtate  [librotate]) 

This  library  contains  functions  related  to  vehicle  internal  kineniatics. 


2.5.18.1  librot  loc.h 


Defines: 

IKIN_SET 

IKIN.OLD 

IKIN_NEW 

IKIN_CLASS_PLAIN 

IKIN_CLASS_STAB_PARENT 

IKIN_CLASS_STAB_CHILD 

IKIN_CLASS_STAB_ORPHAN 

IKIN_CLASS_OFFSET 

IKIN_COMMAND_FREEZE 

IKIN_CX)MMAND_ANGLE 

IKIN_COMMAND_RATE 

IKIN_COMMAND_ANGLE_AND_RATE 

IKIN_COMMAND_VECTOR_STAB 

IKIN_COMMAND_POINT_STAB 

IKIN_COMMAND_RATE_STAB 

IKIN_OOMMAND_ORIENT 

IKIN_CX)MMAND_LOCATE 


External  Procedure  Declarations: 
rotate_relate_init() 
rotate~relate~simul  0 
rotate”set_transforin() 
rotate~set~location() 
rotate~bre'ak_links() 

rotate~vaIidJanglc() 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.5.18.2  librotate.h 

Includes  "sim_types.h" 

Defines; 

ROTATE_MAX_CHILDREN 

ROTATE_NULL 

ROTATE_ELEMENT_DEF0 

The  rotate  element  structure  is  composed  of  the  following  members: 

1)  parent 

2)  child[ROTATE_MAX_CHILDREN] 

3)  class 

4)  iotate_node 

5)  axis 

6)  angle 

7)  sin_ang 

8)  cos_ang 

9)  rate 

10)  transformjndex 

11)  locationjndex 

12)  stop_neg 

13)  stop_pos 

14)  max_rate 

15)  dynamics_on 

16)  dynamic_gain 

17)  dynamic_zero 

18)  pre_command_function() 

19)  post_conimand_function() 

20)  the  orientation  structure  member,  which  is  composed  of: 

a)  command 

b)  matrix 

c)  rate 

d)  angle 

e)  last_angle 

f)  angle_status 

g)  node 

21)  the  location  structure  member,  which  is  composed  of: 

a)  command 

b)  vector 

c)  rate 

d)  node 

22)  the  stab  info  union  member,  which  is  composed  of: 

a)  stab_vector 

b)  iht  family  structure,  which  is  composed  of  the  following 
members: 

1)  stab_child 

2)  priority_child 

23)  stab.  Dase 

24)  stab..cross_prod 

25)  stab.dot_prod 

26)  slab  '  :)mmand_status 
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The  type  ROTATE_ELEMENT  is  defined  as  a  totate_eleinent  structure. 

External  Declarations; 
rotate_init() 
rotate"  simulO 
worldO 

rotate_init_cig_clemeiit{) 

rotate~reassign_cig_eleinent() 

rotate~reset  ci^lisFO 

rotate“get_cIg_info() 

rotate"send_insgs() 

hullQ  " 

rotate_hull_init() 

rotate~huirsiniul() 

rotate~alIocate_elenient() 

rotate~init_element() 

rotate”lnirstab_fainiiy() 

rotatejlnit~stabJbrphan() 

rotate"  init_offset_eleinent() 

rotate~prio"ritize_eieinents() 

rotate~set_child3>‘iority() 

rotate^set^stops'C) 

rotatejset_max_rate() 

rotate"set~dynainic_characteristics() 

rotate"set~dynainic“state() 

rotate~seC"®>.*’®t®t®() 

rotate“seC"*^^() 

rotate"set”angle() 

rotate“seC>'^‘t®() 

rotate”set~angle_and_rate() 

rotate"set][current_angle() 

rotate^inodify_stab_offset() 

rotate~s«t_stab_vectbr() 

rotate”set~stab~vector_in_coordinates() 

rotate_setjstab3ur»'enF_positfon() 

rotate”set”stab^current_position_in_coordinates() 

rotate”set~stab”point() 

rotate_set”stab~point_in_coordinates() 

rotate_setjstab_rate()~ 

rotate"set~stab_rate_in_coordinates() 

rotate”set"loc()" 

rotate~get_angle() 

rotate”get~sin_angle() 

rotate~get”cos”angIe() 

rotatejgetJrateT) 

rotate3|get"mat() 

rotate~get~loc() 
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2.5.18.3  rot_comm.c 

The  routines  in  this  file  are  called  by  other  modules  in  the  vehicle  software  package,  and 
not  by  other  routines  within  librotate.  If  none  of  the  routines  are  called  outside  librotate, 
this  file  will  not  be  linked  with  the  rest  of  the  vehicles  code,  and  none  of  the  included 
libraries  need  be  linked. 

This  file  contains  routines  which  allow  graphical  displays  to  be  driven  in  a  transparent 
fashion.  Nodes  in  the  CIG  configuration  tree  can  be  associated  with  rotate  elements  and 
messages  will  be  sent  to  the  CIG  to  update  these  nodes.  Note  that  the  hull  node,  which  is  a 
child  of  the  world  node,  is  maintained  here. 

"stdio.h" 

"sim_dfns.h" 

"sim_types.h" 

"libhulLh" 

"libkin.h" 

"libmsg.h" 

"librotate.h" 

Declaring  the  malloc()  gives  the  ability  to  dynamically  allocate  memory. 

A  cig_element  is  defined  and  established  for  each  CIG  node  which  is  to  be  driven  by  the 
rotate  package.  All  the  elements  are  stored  in  a  linked  list.  The  cig_element  structure  is 
defined  with  the  following  members: 

next  -  The  next  element  on  the  list. 

cig  id  "  The  id  of  the  CIG  which  paints  the  diplay  for  this  node. 

cigjiode  -  The  number  of  this  node. 

parent  --  The  parent  of  htis  node,  that  is,  the  parent  define  in  the  CIG 

configuration  tree.  This  parent  node  does  not  have  to  be  the  parent 
of  the  child  defined  in  the  rotate  tree. 
child  -  The  child  node. 

In  addition,  the  following  variables  are  declared: 

first  element  —  A  pointer  to  the  first  element  in  the  list.  Initially,  the  list  is  empty. 
current  ekment  -  A  pointer  to  the  element  whose  information  will  be  sent  to  the  CIG 
next 

The  hull  is  defined  with  ROTATE_ELEMENT_DEF(hull_element) 
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2.5.18.3.1 


rotate_init_cig_eIement 


This  routine  properly  stores  CIG  node  information  in  the  local  list.  If  an  element  has 
already  been  defined  for  this  cig  id  -  cig  node  pair,  the  parent_and_childJrtformation  is 
updat^,  otherwise  a  new  element  is  added  to  the  list.  Parameters  are  represented  as 
follows: 


cigid 

cigjiode 

parent 

child 


—  The  id  of  the  CIG  which  displays  this  node. 

—  The  number  of  the  node  as  defined  in  the  CIG  configuration  file. 

~  A  pointer  to  the  rotate  element  which  is  the  parent  of  the  node  as  defined  in 
the  CIG  configuration  file. 

—  A  pointer  to  the  rotate  element  which  the  CIG  node  is  attached  to. 


First  the  current  element  variable  is  set  to  point  at  the  beginning  of  the  list  of  CIG 
elements.  A  search  through  the  list  is  performed  to  locate  the  cigid  -  cigjiode  pair.  If  this 
pair  has  been  assigned  an  element  before,  its  parent  and  child  information  is  updated,  and 
current  element  is  reset  to  point  at  the  beginning  of  the  list.  If  the  pair  has  not  been 
assigned  an  element,  memory  is  allocated.  If  memory  has  been  exhausted,  an  error 
message  is  printed.  Once  the  element  is  assigned,  it  is  inserted  at  the  beginning  of  the  Ust 
and  the  parent  and  child  information  is  filled  in. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ciQ  id 

int 

Standard 

ciQ  node 

int 

Standard 

parent 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.28.2  librotate.h 

child 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.28.2  librotate.h 

1  Errors  1 

Error 

Reason  for  Error 

LIBROTATE(rotate  init  cio  element):  FATAL 

cannot  allocate  entry  for  CIG  node 

Table  2.5>342:  rotate_init_cig_element  Information. 
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2.5.18.3.2  rotate_reassi  gn_cig_element 

This  routine  allows  branches  of  the  CIG  configuration  tree  to  be  attached  to  different  parts 
of  the  simulated  vehicle.  For  example,  if  a  vehicle  has  a  turret,  a  gun  which  can  elevate  is 
attached,  as  is  a  sensor  that  can  traverse  and  elevate  with  respect  to  the  turret  One  CIG 
node  could  be  attached  to  the  turret  and  another,  initially,  to  the  gun.  By  changing  the  child 
in  the  CIG  element  originally  assigned  to  the  turret,  the  node  coidd  be  attached  to  the 
sensor. 


The  routine  returns  a  pointer  to  the  rotate  element  which  was  the  child  associated  with  the 
CIG  element.  Parameters  and  variables  are  represented  as  follows: 


cigjd 

cignode 


child 

element 

oldchild 


-  The  id  of  the  CIG  which  displays  this  node 

--  The  number  of  the  node  as  defined  in  the  CIG  configuration  file.  The 
combination  of  cig  id  and  cig  node  uniquely  identifies  a  single  QG  display 
node  or  CIG  element. 

-  A  pointer  to  the  rotate  element  which  will  now  be  the  child  associated  with 
the  CIG  element. 

“  A  pointer  to  an  element  in  the  list. 

“  A  pointer  to  the  rotate  element  last  assigned  to  this  CIG  element. 


This  is  accomplished  by  setting  element  to  point  at  the  beginning  of  the  list  and  searching 
for  the  CIG  element.  If  the  CIG  element  is  found,  it  resets  the  child  and  returns  the  pointer 
to  the  old  child.  If  the  CIG  element  is  not  found,  it  returns  a  NULL  pointer. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ciq  id 

int 

Standard 

cia  node 

int 

Standard 

child 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.28.2  librotate.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

element 

pointer  to  struct  cia  element 

Section  2.5.18.3  rot  comm.c 

old_child 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.28.2  librotate.h 

1  Return  Values  1 

Return  Value 

Meaning 

ROTATE_NULL 

pointer  to 

ROTATE  ELEMENT 

the  CIG  element  was  not 
found 

old_child 

pointer  to 

ROTATE  ELEMENT 

the  old  child  associated  with 
the  CIG  element 

Table  2.5-343:  rotate_reassign_cig_element  Information. 
2.5.18.3.3  rotate_reset_cig_list 


This  routine  resets  current  element  to  point  to  the  beginning  of  the  list. 
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2.5.18.3.4 


rotate_get_cig_info 


This  routine  passes  back  the  information  the  CIG  needs  about  the  element  pointed  at  by 
current  element.  If  valid  information  is  returned,  TRUE  is  returned  and  current  element  is 
set  to  point  at  the  next  entry  in  the  list.  If  the  end  of  the  list  has  been  reached,  FALSE  is 
returned  and  current_ele:nent  is  reset  to  point  at  the  beginning  of  the  list. 


cigjd  —  A  pointer  to  the  id  of  the  CIG  associated  with  the  current  CIG  element 
cig_node  -  A  pointer  to  the  number  of  the  node  associated  with  the  current  CIG 
element 

mat  —  A  pointer  to  the  matrix  which  contains  the  transformation  ftom  the  parent  in 

the  current  CIG  element  to  the  child. 

loc  —  A  pointer  to  the  location  of  the  child  in  the  current  CIG  element  with  respect 

to  the  the  parent  expressed  in  the  parent's  coordinate  system. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

cia  id 

pointer  to  int 

Standard 

cia  node 

pointer  to  int 

Standard 

mat 

pointer  to  T_MAT_PTR 

/simnet/common/include/glob 
al/sim  types.h 

loc 

pointer  to  pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

valid  information  about  the 
element  is  returned  to  the  CIG 

TRUE 

int 

the  end  of  the  list  has  been 
reached 

1  Calls  1 

Function 

Where  Described 

rotate  aet  mat 

Section  2.5.18.5.5 

rotate  aet  loc 

Section  2.5.18.5.12 

Table  2.5-344: 


rotate_get_cig_info  Information. 
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2.5.18.3.5  rotate_send_ak5gs 

This  routine  sends  messages  to  fftte  CIG  with  infonnation  about  the  CIG  elements  on  the 
list  The  messages  start  with  the  element  currently  pointed  at  by  current  element  and 
continue  through  to  the  end  of  Are  list.  The  only  time  current  element  should  be  pointing 
anywhere  except  at  the  front  of  list  is  during  the  execution  of  this  routine.  In  this  (the 
standard)  case,  this  routine  win  send  messages  for  all  elements  on  the  list.  This  routine 
should  be  call^  by  the  user  whesn  it  is  appropriate  to  send  messages  to  the  CIG.  Variables 
are  represented  by  the  followingr 


bitfjnask 

cigjtode 

orientation 

location 


variable 


but  mask 


cio  node 


onentation 


location 


-  The  CIG  id. 

--  The  CIG  node. 

--  The  orientation  oif  the  node. 
--  The  location  of  ^  node. 


IBT! 


Internal  Variables 


e 


me 


int 


T  WAT  PTR 


pointer  to  REAL 


Where  Tvpedef  Declared 


Standard 


Standard 


/simnet/common/include/glob 
al/sim  tvDes.h 


/simnet/common/include/glob 
al/sim  tvoes.h 


Function 


rotate  get  cig  info 


multi  cig  msg  oreoend  rts4x3  matrix 


Calls 


Where  Described 


Section  2.5.18.3.4 


Section  2.1.2.2.2.82.1 


Table  2.5-345:  rotate_send_nisgs  Information. 


2.5.18.3.6  hull 

This  routine  returns  the  pointer  ao  the  hull.  Rotate  elements  are  generally  maintained  by  the 
vehicles  code  module  responsible  for  them.  The  exceptions  are  the  world  and  the  hull, 
which  are  maintained  here  (in  liimotate).  In  later  versions  of  the  code,  the  hull  element  will 
be  moved  to  its  own  module. 


Return  Value 


&hull 


Return  Values 


e 


pointer  to 

RK3TATE  ELEMENT 


ion 


Meanin 


the  pointer  to  the  hull  element 


Table  2.5-346:  hull  Information. 
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2.5.18.3.7 


rotate  hull  init 


This  routine  initializes  the  hull  rotate  element.  It  should  be  called  by  the  user  before 
rotate_initO  is  called.  It  is  assumed  that  there  is  a  CIG  connguration  node  (1)  that  is 
associated  with  the  hull.  The  rotate  and  CIG  elements  are  initi^zed,  and  the  initial 
orientation  and  location  of  the  hull  are  set. 


1  Calls  1 

Function 

Where  Described 

rotate  init  element 

Section  2.5.18.4.2 

world 

Section  2.5.18.6.8 

rotate  init  cia  element 

Section  2.5.18.3.1 

rotate  set  mat 

Section  2.5.18.4.16 

kinematics  aet  w  to  h 

Section  2.5.8.2.1 

rotate  set  loc 

Section  2.5.18.4.30 

kinematics  qet  o  to  h 

Section  2.5.8. 2.4 

Table  2.5-347:  rotate_hull_init  Information. 

2.5.18.3.8  rotate_hull_simul 

This  routine  updates  the  current  orientation  and  position  of  the  hull.  It  should  be  called 
every  tick  after  the  hull  kinematics  have  been  performed  and  before  rotate_simul()  is 
called. 


1  Calls  1 

Function 

Where  Described 

rotate  set  mat 

Section  2.5.18.4.16 

kinematics  get  w  to  h 

Section  2.5.8.2.1 

rotate  set  loc 

Section  2.5.18.4.30 

kinematics  qet  o  to  h 

Section  2.5.8. 2.4 

Table  2.5-348:  rotate  hull  simul  Information. 
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2.5.18.4  rot_element.c 

This  file  contains  the  routines  that  operate  on  specific  rotate  elements.  An  element  is  a 
node  in  a  tree  stmcture  that  represents  and  trac^  a  particular  coordinate  system.  The 
routines  in  this  file  provide  the  means  to  initialize  elements,  change  their  characteristics, 
give  commands  for  rotation  and  translation,  and  obtain  information  about  them. 

Includes; 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"libmatrix.h" 

"Ubrotate.h" 

"librot_loc.h" 

Procedure  Declarations: 
mallocO 

rotate_init_stab_element() 

2.5.18.4.1  rotate_allocate_element 

This  roudne  dynamically  allocates  memory  for  an  element,  initializes  the  essential  entries  in 
it,  and  returns  a  pointer  to  it.  This  is  an  alternative  to  the  more  standard  method  of  statically 
allocating  in  vehicle  specific  code  using  the  ROTATE_ELEMENT_DEF  macro.  Using  the 
dynamic  method  requires  the  user  to  be  very  careful  about  the  order  in  which  nodes  are 
allocated  and  initialized:  an  element  must  be  allocated  before  it  is  declared  as  a  parent  of 
any  other  element.  This  declaration  must  take  place  when  the  child  node  is  initialized. 
Variables  are  represented  as  follows: 

I  "  A  counter. 

new_element  -  The  pointer  to  the  new  element. 

The  pointers  to  the  element's  parent  and  children  are  initialized  to  NULL  pointers  and  the 
pointer  to  the  element  is  returned.  If  the  element's  allocation  fails,  an  error  message  is 
printed  and  a  NULL  pointer  is  returned. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

new.element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  iibrotate.h 

1  Return  Values  1 

Return  Value 

Meanlnq 

ROTATE_NULL 

pointer  to 

ROTATE  ELEMENT 

the  element's  allocation  failed 

new_element 

pointer  to 

ROTATE  ELEMENT 

a  pointer  to  the  newly 
allocated  element 

Table  2.5>349:  rotate_allocate_element  Information. 
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2.5.18.4.2  rotate_init_element 

This  routine  performs  all  the  tasks  r^uired  to  initialize  an  element  and  insert  it  into  the 
rotate  tree  structure.  This  initialization  must  be  performed  for  all  elements.  This  routine 
must  be  called  before  any  other  action  is  taken  on  the  element  and  before  rotate_init()  is 
called.  The  order  in  which  the  parent  element  and  its  children  are  initialized  is  noT 
important.  After  being  initialized,  this  element  is  of  IKIN_CLASS_PLAIN.  Other 
initialization  routines  must  be  called  to  modify  its  class.  Parameters  are  represented  as 
follows: 


element 


parent 
axis  X 


axis_y 

axis_z 

angle 

stopjieg 


stop _pos 


f'ax_rate 

locjc 

loc_y 
loc  z 


-  A  pointer  to  the  rotate  element  to  be  initialized.  Note  that  the  element  must 
be  declared  statically  or  dynamically  by  the  module  responsible  for  it, 
generally  the  vehicle  specific  code.  This  declaration  must  be  performed 
using  the  macro  ROTATE_ELEMENT_DEF  which  is  defined  in 
"librotate.h"  or  by  using  the  routine  rotate_allocate_element(). 

"  The  pointer  to  the  element  which  is  the  parent  of  this  element. 

-  It  can  be  shown  that  the  relationship  between  any  two  cooridnate  systems 
can  be  expressed  as  an  axis  and  angle  of  rotation.  When  the  angle  is  0.0,  the 
systems  are  coincident.  For  any  angle,  the  axis  has  the  s^me  expression  in 
either  system.  This  parameter  is  the  X  coordinate  of  the  axis  of  rotation. 

-  The  Y  coordinate  of  the  axis  of  rotation. 

“  The  Z  coordinate  of  the  axis  of  rotation. 

-  The  initial  angle  of  rotation  in  radians. 

"  The  angle  in  radians  that  the  element  is  not  allowed  to  pass  if  it  is  rotating  in 
the  negative  direction.  If  this  is  not  a  valid  angle  (>(-Pl)  and  <=P1),  the 
element  does  not  have  a  negative  stop. 

--  The  angle  in  radians  that  the  element  is  not  allowed  to  pass  if  it  is  rotating  in 
the  positive  direction.  If  this  is  not  a  valid  angle  (>(-Pl)  and  <=P1),  the 
element  does  not  have  a  positive  stop. 

-  The  maximum  rate  the  element  is  allowed  to  turn  in  radians  per  tick. 

-  The  X  coordinate  of  the  location  of  the  element  with  respect  to  its  parent  in 
the  parent's  coordinate  system  in  meters. 

-  The  Y  coordinate  of  the  location  in  meters. 

-  The  Z  coordinate  of  the  location  in  meters. 


In  order  to  initialize  the  element,  the  routine  fust  checks  to  see  if  the  element  is  the  world 
rotate  element.  If  the  element  is  the  world,  then  the  element  has  no  parent,  since  the  world 
is  the  top  of  the  rotate  tree.  If  the  element  is  not  the  world,  then  the  routine  makes  the 
element  a  child  of  its  parent  If,  however,  this  element  has  already  been  initialized,  it  is 
already  a  child  of  its  parent  If  the  element  can  not  make  itself  a  child  of  its  parent  the 
initialization  fails.  Since  all  elements  are  declared  using  ROTATE_DEF_ELEMENT  or 
rotate_allocate_eIement(),  the  pointers  to  a  parent  element's  children  are  NULL  until  a 
child  iradoptetk'a  parent  will  know  nothing  of  its  children  until  the  child  attaches  itself.  In 
order  to  attach  itsetf ,  the  pointer  to  the  child  element  is  stored  in  the  fust  NULL  entry  in  the 
parent's  child  list. 

Once  attached,  the  entry  is  initialized.  First,  the  entries  of  the  rotate  element  are  filled  in, 
and  the  axis  vector  is  normalized.  The  dynamics  are  initially  turned  off  and  the  gain  and 
zero  values  are  initialized  such  that  the  element  would  have  an  instantaneous  response  if  the 
dynamics  were  turned  on  without  setting  them.  The  command  pointers  are  initialized  to 
NULL.  The  node  orientation  is  initially  locked  in  place.  If  the  element  is  the  world,  its 
location  cannot  be  moved.  If  the  element  is  not  the  world,  a  command  is  issued  to  place  the 
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element;  the  placement  will  occur  during  the  initial  pass  through  rotate_exec().  If  the 
initialization  was  successful,  the  routine  retiuns  TRUE.  ~ 


Parameter 


element 


parent 


axis_y 


angle 


stop_neg 


stopjpos 


max  rate 


Parameters 


pointer  to 

ROTATE  ELEMENT 


pointer  to 

ROTATE  ELEMENT 


REAL 


REAL 


REAL 


REAL 


Where  Typedef  Declared 


Section  2.5.18.2  librotate.h 


Section  2.5.18.2  librotate.h 


/simnet/common/include/glob 
al/sim  types.h 


/simnet/common/include/glob 
al/sim  types. h 


/simnet/common/include/glob 
al/sim  types.h 


/simnet/common/include/glob 
al/sim  types.h 


/simnet/common/include/glob 
al/sim  types.h 


/simnet/common/include/glob 
al/sim  types.h 


/simnet/common/include/glob 
al/sim  types.h 


/simnet/common/include/glob 
al/sim  types.h 


/simnet/common/include/glob 
al/sim  types.h 


/simnet/common/include/glob 
al/sim  types.h 


Variable 


lEiT] 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard 


Return  Value 


FALSE 


TRUE 


Return  Values 


Meanin 


rocedure  failed 


the  initialization  was 
successful 


Calls 

Function 

Where  Described 

world 

Section  2.5.18.6.8 

vec  normalize 

Section  2.6.2.63.1 

rotate  valid  angle 

Section  2.5.18.6.7 

rotate  set  stops 

Section  2.5.18.4.9 

rotate  set  max  rate 

Section  2.5.18.4.10 

Table  2.5-350:  rotate  init  element  Information. 
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2.5.18.4.3 


rotate_init__stab_family 


The  goal  of  stabilization  is  to  align  the  base  vector,  which  is  fixed  in  the  child's  coordinate 
system,  with  the  stab  vector, which  is  fixed  in  some  other  coordinate  system.  In  the  case  of 
a  stab  family,  two  coordinate  systems  can  be  rotated  to  accomplish  this  goal.  This  routine 
performs  the  initializations  required  to  configure  the  pair  to  a  stab  family.  Paramenters  are 
represented  as  follows: 


stab_child 

basejc 


base_y 

basejc 

prioritychild 


-  A  pointer  to  the  child  of  the  stab  family  pair. 

-  The  base  vector  is  fixed  to  the  child's  system  and  is  aligned  with  the 
stab  vector.  This  parameter  is  tiie  X  coordinate  of  the  base  vector 
expressed  in  the  child's  coordinates. 

-  The  Y  coordinate  of  the  base  vector. 

-  The  Z  coordinate  of  the  base  vector. 

-  TRUE  if  the  rotations  are  done  to  minimize  the  rotation  of  the  child  or 
FALSE  if  the  rotation  of  the  parent  is  minimized. 


The  routine  first  initializes  the  child  and  set  its  class,  and  then  initializes  the  parent  and  sets 
its  class.  The  base  vector  of  the  parent  is  the  child's  axis.  The  two  systems  are  then 
connected  by  setting  stab  child  and  setting  the  priority. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

base_x 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

base_y 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

base_2 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

1  Calls  1 

Function 

Where  Described 

rotate  init  stab  element 

Section  2.5.18.4.5 

Table  2.5-351: 


rotate_init_stab_family  Information. 
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2.5.18.4.4  rotate_init_stab_or phan 
element  -  A  pointer  to  the  element  to  be  stabilized. 

basejc  -  The  base  vector  is  fixed  to  the  child's  system  and  is  aligned  with  the  stab 

vector.  This  parameter  is  the  X  coordinate  of  the  base  vector  expressed  in 
the  child's  coordinates. 

base_y  --  The  Y  coordinate  of  the  base  vector. 

base_z  --  The  Z  coordinate  of  the  base  vector. 

In  order  to  stabilize  a  stab  orphan,  only  one  coordinate  system  can  be  rotated  to  align  the 
base  vector  with  the  stab  vector.  This  routine  performs  Ae  initializations  required  to 
configure  the  element  to  a  stab  orphan. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

base_x 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

base_y 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

base_2 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

1  Calls  1 

Function 

Where  Described 

rotate  init  stab  element 

Section  2.5.18.4.5 

Table  2.5-352:  rotate_lnit_stab_orphan  Information. 
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2.5.18.4.5  rotate_init_stab_eleinent 

This  routine  fills  in  the  entries  in  the  rotate  element  structure  that  deal  with  stabilization. 
Note  that  in  a  stab  parent,  the  child's  axis  acts  like  a  base  vector.  This  is  shown  elsewhere. 
First  the  base  vector  is  filled  in  and  normalized.  The  cross  and  dot  products  of  the  base 
vector  and  the  axis  are  found.  The  command  status  in  initialized.  Parameters  are 
represented  as  follows; 

element  —  A  pointer  to  the  element  to  be  stabilized. 

basejc  —  The  base  vector  is  fixed  to  the  child's  system  and  is  aligned  with  the  stab 

vector.  This  parameter  is  the  X  coordinate  of  the  base  vector  expressed  in 
the  child's  coordinates. 

base_y  -  The  Y  coordinate  of  the  base  vector. 

base  z  -  The  Z  coordinate  of  the  base  vector. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

base_x 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

base_y 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

base_z 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

1  Calls  1 

Function 

Where  Described 

vec_normali2e 

Section  2.6.2.63.1 

vec  cross  prod 

Section  2.6.2.66.1 

vec  dot  prod 

Section  2.6.2.54.1 

Table  2.5-353:  rotate_init_stab_element  Information. 

2.5.18.4.6  rotate_init_offset_element 

An  offset  element  is  one  that  is  aligned  with  its  parent  but  is  offset.  This  routine  initializes 
this  type  of  element.  The  parameter  element  is  a  pointer  to  the  element  which  is  to  be  in  the 
offset  class. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

Table  2.5-354:  rotate_lnit_offset_element  Information. 
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2.5.18.4.7  rotate_prioritize_eleinents 

Sometimes  it  is  desirable  to  have  one  node  processed  before  another.  As  an  example,  it 
may  be  necessary  to  stabilize  a  low  priority  node  to  a  point  expressed  in  the  high  priority 
node's  coordinates.  The  routine  returns  TRUE  if  it  is  possible  to  reorder  the  children  of  an 
element  such  that  high  is  operated  on  before  low,  and  returns  FALSE  otherwise. 
Parameters  are  represented  as  follows: 

high  -  A  pointer  to  the  element  which  is  to  be  operated  on  first. 

low  -  A  pointer  to  the  element  which  is  to  be  operated  on  last 

The  routine  first  checks  to  see  if  high  is  an  ancestor  of  low.  If  so,  high  will  be  operated  on 
first,  and  TRUE  is  returned.  If  not,  the  routine  tries  to  find  the  common  ancestor  of  high 
and  low.  The  variable  current  high  is  first  set  to  high  and  is  then  set  to  each  of  its 
ancestors  until  the  top  of  the  tree  is  reached.  Next,  the  variable  current  low  is  set  to  low 
and  is  then  set  to  each  of  its  ancestors  until  the  top  of  the  tree  is  reached.  A  check  is  made 
to  see  if  the  parent  of  current  low  and  the  parent  of  current  high  are  the  same.  If  so,  the 
common  ancestor  has  been  found.  If  current  high  and  current  low  are  the  same,  and  since 
the  possiblility  of  high  being  an  ancestor  of  tow  has  already  been  eliminated,  low  is  either 
the  same  as  high  or  it  is  a  direct  ancestor,  FALSE  is  returned  since  low  must  be  operated  on 
before  high. 

Next,  each  of  the  children  of  the  common  ancestor  is  looped  through.  If  current  high  is 
reached  first,  it  is  being  operated  on  first,  and  TRUE  is  returned.  If  current  low  is  reached 
first,  the  two  elements  are  swapped  in  the  array  of  children. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

high 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

low 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

current_high 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

currentjow 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

parent 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

i 

int 

Standard 

index 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

FALSE 

int 

it  is  not  possible  to  reorder  the 
children 

TRUE 

int 

it  is  possible  to  reorder  the 
children 

Table  2.5-355:  rotate_prioritize_elements  Information. 
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2.5.18.4.8  rotate_set_child_priority 

This  routine  sets  the  child  priority  flag  for  a  stab  family.  TRUE  is  returned  if  rotation  of 
the  child  is  minimized,  and  FALSE  is  returned  if  rotation  of  the  parent  is  minimized. 
Parameters  are  represented  as  follows: 

element  -  A  pointer  to  the  element  of  interest. 
priority  -  The  child  priority  flag. 


Parameter 


element 


Parameters 


pointer  to 

ROTATE  ELEMENT 


int 


Where  Typedef  Declared 


Section  2.5.18.2  librotate.h 


Standard 


Return  Value 


TRUE 


FALSE 


lETT 


Return  Values 


Meanln 


the  rotation  of  the  child  is 
minimized 


the  rotation  of  the  parent  is 
minimized 


Error 


ROTATE:  rotate  set  child  oriorit 


Errors 


Reason  for  Error 


trvino  to  orioritize  inappropriate  class 


Table  2.5-356:  rotate_set_child_priority  Information. 
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2.5.18.4.9  rotate_set_stops 


element 

stopneg 

stop _pos 


-  A  pointer  to  ahe  elenwnt  of  interest. 

-  The  angle  in  radians  that  the  element  cannot  turn  past  when  rotating  in  the 
negative  diretcdon. 

-  The  angle  in  radians  that  the  element  cannot  turn  past  when  rotating  in  the 
positive  diroction. 


This  routine  sets  the  stops  associated  with  an  element.  If  the  stop  setting  is  an  invalid  angle 
(<=  -PI  or  >  PI),  then  there  us  no  stop  in  that  direction.  An  angle  indicating  no  negative 
stop  should  be  less  than  -PE^d  an  angle  indicating  no  positive  stop  should  be  greater  than 
PI  in  order  for  the  stop  detemiining  algorithm  to  perform  efficiently.  This  routine  accepts 
-PI  but  converts  it  to  the  valid  value  of  PL  If  the  stops  are  set  at  the  same  angle,  they  must 
be  separated  so  the  stop  algorithm  will  work  properly.  This  separation  will  allow  the 
element  to  rotate  virtu^y  tfaraugh  the  whole  circle  but  it  will  stop  at  the  stop  point  when 
going  in  either  direction. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

element  - 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

stop_neg 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

stop_pos 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

Table  2.5-357:  rotate_set_stops  Information. 


2.5.18.4.10  rotate_set_max_rate 

This  routine  sets  the  maxinEim  allowed  rate  of  rotation.  Parameters  are  represented  as 
follows: 

element  -  A  pointer  to  che  element  of  interest. 

maxjrate  —  The  maximum  allowed  rate  of  rotation  of  the  element  in  either  direction  in 
radians  per  dick. 


I  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

max_rate 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

Table  2.5>358:  rotate  set  max  rate  Information. 
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2.5.18.4.11 


rotate_set_dynamic_characteristics 


element 
not Jreq 
dampingjac  — 


A  pointer  to  the  element  of  interest. 

The  natural  frequency  of  the  system  in  radians  per  tick. 
The  damping  factor  of  the  system. 


Nodes  can  be  given  dynamic  characteristics  in  rotation.  A  very  simple  transfer  function  is 
used  to  represent  the  passive  dynamics  of  the  mass,  stiffness,  and  damping  and  its 
modification  by  active  control.  The  criteria  for  such  behavior  is  that  the  system  should 
have  zero  steady-state  error  for  constant  velocity  input  and  should  be  stable.  This  behavior 
is  exhibited  by  the  system  illustrated  below.  This  system  has  unity  and  negative  feedback. 
The  two  pure  integrators  in  the  open  loop  transfer  function  result  in  zero  steady- state  error. 
The  single  pole  tribes  the  system  stable 


The  resultant  transfer  function  of  this  system  is: 


T(s)  = 


as) 

R(s) 


K(s  +  z) 

+  Ks  +  Kz 


The  response  characteristics  of  this  system  can  be  determined  from  the  denominator  of  this 
equation  (the  characteristic  equation).  The  standard  form  of  the  second  order  characteristic 
equation  is: 

+  2ciws  -H  Vi/^ 

where  d  is  the  damping  factor  and  w  is  the  natural  frequency.  Expressing  the  characteristic 
equation  of  the  system  derived  above  in  this  form  yields: 


K=2dw 


This  routine  expresses  the  node's  dynamic  characteristics  in  terms  of  the  natural  frequency 
and  damping  factor.  The  dynamic  characteristics  can  be  set  at  any  time  after  the  node  has 
been  initialized  and  can  be  modified  at  any  time.  The  characteristics  should  be  set  before 
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the  dynamics  of  the  node  are  turned  on.  There  is  no  need  to  set  the  characteristics  if  the 
dynamics  are  not  to  be  used  for  the  node. 

When  the  dynamics  are  turned  on,  the  node  reacts  to  inputs  of  desired  position  and  desired 
rate.  Each  of  the  command  states  tries  to  generate  reasonable  values  for  these  inputs. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

natjreq 

REAL 

/simnet/common/include/glob 
al/sim  tvoes.h 

dampingjac 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

Table  2.5-359:  rotate_set_dynamic_characteristics  Information. 
2.5.18.4.12  rotate_set_dynamic_state 

element  —  A  pointer  to  the  element  of  interest. 

dynamics  on  -  The  desired  state  (ON  or  OFF)  of  the  dynamics  of  the  element. 

The  dynamics  of  a  node  are  initially  turned  off  and  are  active  only  when  turned  on.  This 
routine  turns  the  dynamics  of  a  node  on  or  off.  The  dynamic  characteristics  of  the  node 
should  be  set  before  they  are  turned  on. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

dynamics  on 

int 

Standard 

Table  2.5-360: 


rotate_set_dynamic_state  Information. 


1266 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.5.18.4.13 


rotate_set_pre_command_function 


element  —  A  pointer  to  the  element  of  interest 

function _ptr  -  A  pointer  to  a  function  that  returns  an  integer  and  passes  a  pointer  to  a 

rotate  element  as  an  argunent  This  fimction  will  be  called  every  tick 
just  before  the  element  is  operated  on. 


This  routine  allows  the  user  to  specify  a  function  which  will  be  called  after  all  higher 
priority  elements  have  been  operated  on  but  before  this  element  is  operated  on.  The 
function  declaration  should  appear  as  follows: 

int  function_ptr  (element) 

ROTATE_ELEMENT  *element; 

{ 


)‘ 

The  pointer  passed  in  the  call  will  be  element.  The  return  value  is  not  used  and  has  no 
meaning.  If  a  function  has  been  set  previously  and  it  is  desired  to  not  have  a  function 
called,  diis  routine  is  used  to  set  the  function  pointer  to  ROTATE_NULL. 


i  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

function_ptr 

pointer  to  a  function  that 
returns  an  int 

Standard 

Table  2.5>361:  rotate_set_pre_conimand_function  Information. 
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2.5.18.4.1« 


rotate_set_post_conimand_function 


This  routine  alfiows  the  user  to  specify  a  function  which  will  be  called  after  all  higher 
priority  elemeints  have  been  operated  on  and  after  this  element  is  operated  on.  The  function 
declar^on  shcsuld  look  like: 


int  function _ptr  (element) 
ROTATEJELEMENT  *element; 


)* 

element  ~  ApcnntertotheelementofinteresL 

function _ptr  ~  A  pointer  to  a  funcdondiat  returns  an  integer  and  passes  a  pointer  to  a 

rotate  element  as  an  argument  This  function  will  be  called  every  tick 
just  after  the  element  is  operated  on. 

The  pointer  passsed  in  the  call  will  be  element.  The  return  value  is  not  used  and  has  no 
meaning.  If  a  function  has  been  set  previously  and  it  is  desired  to  not  have  a  function 
called,  &s  routdne  is  used  to  set  the  function  pointer  to  ROTATE_NULL. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

function jatr 

pointer  to  a  function  that 
returns  an  int 

Standard 

Table  2.5-362:  rotate_set_post_command_function  Information. 

2.5. 18.4.  IS  rotate_set_no_rotate 

This  routine  imues  a  command  to  lock  the  element  in  place.  The  dynamic  characteristics 
are  ignored.  TSie  parameter  element  represents  a  pointer  to  the  element  of  interest. 

If  the  element  was  previously  stabilized  and  is  a  member  of  a  stab  family,  the  other  member 
of  the  family  will  also  be  locked  into  place.  Typically,  another  call  would  be  made  to  the 
other  meml^r  to  verify  its  command  status. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

Tabic  2.5-363:  rotate  set  no  rotate  Information. 
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2.5.18.4.16  rotate_set_mat 

element  —  A  pointer  to  the  element  of  interest 
parent_to_self  -  A  pointer  to  the  parent  to  self  transformation  matrix. 

This  routine  issues  a  command  to  set  the  orientation  madix  of  an  element.  Note  that  the 
element  can  no  longer  be  thought  of  in  terms  of  rotating  about  its  axis  and  that  the  dynamic 
characteristics  have  no  bearing. 

If  the  element  was  previously  stabilized  and  is  a  member  of  a  stab  family,  the  other  member 
of  the  family  will  also  be  locked  into  place.  Typically,  another  call  would  be  made  to  the 
other  memter  to  verify  its  command  status. 


I  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

parent_to_self 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

mat  copy 

Section  2.6.2.39 

Table  2.5*364:  rotate_set_mat  Information. 

2.5.18.4.17  rotate_set_angIe 

element  --  A  pointer  to  the  element  of  interest. 

angle  —  The  desired  angle  with  respect  to  the  parent  [radians]. 

This  routine  issues  a  command  to  rotate  to  a  specified  angle  relative  to  the  parent.  If 
dynamics  are  turned  on,  this  angle  is  the  desii^  angle.  ITie  transition  into  this  command 
mode  results  in  the  desired  rate  being  set  to  0.0.  If  this  routine  is  called  every  tick,  the 
difference  between  successive  calls  is  used  as  the  desired  rate.  If  a  tick  passes  without  a 
call  to  this  routine,  the  desired  rate  is  set  to  0.0.  If  the  element  was  previously  stabilized 
and  is  a  member  of  a  stab  family,  the  other  member  of  the  family  will  also  be  locked  into 
place.  Typically,  another  call  would  be  made  to  the  other  member  to  verify  its  command 
status. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

angle 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

I  Calls  I 

Function 

Where  Described 

rotate  valid  angle 

Section  2.5.18.6.7 

Table  2.5-365;  rotate_set_angle  Information. 
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2.5.18.4.18  rotate_set_rate 

element  -  A  poomer  to  the  element  of  interest 

nxte  —  The^^flfcssiredrateofrotationinr^anspertick. 

This  routine  issues  atcommand  to  rotate  at  a  specified  rate.  If  dynamics  are  turned  on,  the 
current  angle  is  usedias  the  desired  angle. 

If  the  element  was  pneviously  stabilized  and  is  a  member  of  a  stab  family,  the  other  member 
of  the  family  will  also  be  locked  into  place.  Typically,  another  call  would  be  made  to  the 
other  member  to  verrlfy  its  command  status. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

rate 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

Table  2.5*366:  rotate  set  rate  Information. 


2.5.18.4.19  rotate_set_angle_and_rate 

element  -  A  poitater  to  the  element  of  interest. 

angle  —  The  desired  angle  with  respect  to  the  parent  [rad]. 

rate  -  The  desired  rate  of  rotation  in  radians  per  tick. 

This  routine  is  used  primarily  to  set  the  desired  angle  and  rate  of  a  node  when  dynamics  are 
turned  on.  If  the  dyreamics  are  turned  off,  the  node  will  turn  at  the  specified  rate  (if 
possible)  until  the  dessired  angle  is  reached 

If  the  element  was  pnsviously  stabilized  and  is  a  member  of  a  stab  family,  the  other  member 
of  the  family  will  also)  be  locked  into  place.  Typically,  another  call  would  be  made  to  the 
other  memter  to  verify  its  command  status. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

angle 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

rate 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

Calls 

Function 

Where  Described 

rotate  valid  angle 

Section  2.5.18.6.7 

Table  2.5-367;  rotate_set_angIe_and_rate  Information. 
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2.5.18.4.20 


rotate_set_current_angIe 


This  routine  will  cause  the  node  to  come  to  rest  at  its  current  position.  If  dynamics  are 
turned  off,  this  will  have  the  same  effect  as  the  routine  rotate_set_no_rotate()  but  will 
be  computationally  more  expensive.  If  dynamics  are  turned  on7theliode  will  settle  onto  its 
current  position.  The  parameter  element  represents  a  pointer  to  the  element  of  interest. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

Calls 

Function 

Where  Described 

rotate  set  anale 

Section  2.5.18.4.17 

Table  2.5-368:  rotate_set_current_angIe  Information. 

2.5.18.4.21  rotate_modify_stab_offset 

element  —  A  pointer  to  the  element  of  interest. 

offset  —  Desired  angular  offset  from  the  stab  vector  in  radians. 


This  routine  modifies  the  offset  used  for  element  when  it  is  in  stab  vector  or  point  stab 
mode.  The  node  must  be  a  stabilized  element  to  be  in  stab  vector  or  point  stab  mode.  The 
offset  is  reset  to  zero  when  the  node  transitions  into  either  of  those  command  modes  or 
when  the  coordinate  system  of  the  stab  vector  or  stab  point  changes.  If  the  element  is  not 
in  vector  stab  or  point  stab  mode,  an  error  message  is  printed. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

offset 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

Errors 

Error 

Reason  for  Error 

ROTATE:  rotate  modify  stab  offset 

element  not  in  appropriate  stab  mode 

Table  2.5-369: 


rotate_modify_stab_offset  Information. 
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2.5.18.4.22  rota  te_set_stab_vector 
element  —  A  pointer  to  the  element  of  interest. 

stab_yector  -  A  pointer  to  the  stab  vector  which  is  expressed  in  world  coordinates. 

This  routine  sets  the  stab  vector  which  is  expressed  in  world  coordinates  by  calling  the 
more  general  routine  rotate_set_stab_vector_ln_coordinates(). 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

stab_vector 

VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

1  Calls  1 

Function 

Where  Described 

rotate  set  stab  vector  in  coordinates 

Section  2.5.18.4.23 

Table  2.5-370:  rotate_set_stab_vector  Information. 
2.5.18.4.23  rotate  set  stab  vector  in  coordinates 


Parameters  and  variables  are  represented  as  follows: 


element 

stab_yector 

coords 

parent 

child 


-  A  pointer  to  the  element  of  interest. 

"  A  pointer  to  the  stab  vector  which  is  expressed  in  the  coordinates  of  node 
coords. 

-  A  pointer  to  the  element  whose  coordinates  the  stab  vector  is  expressed  in. 
”  A  pointer  to  the  parent  in  the  family. 

”  A  pointer  to  the  child  in  the  family. 


This  routine  sets  the  stab  vector  which  is  in  the  coordinates  of  element  coords,  coords 
should  be  moved  before  element  by  calling  rotate_prioritize_eIements()  except  when 
this  routine  is  called  from  rotate_set_stab_vector(),  since  the  world  is  always  fixed. 


This  routine  sets  the  command  mode  of  element,  and,  if  it  is  in  a  stab  family,  sets  its  other 
family  member.  If  element  is  not  in  a  stab  family  or  is  not  a  stab  orphan,  this  routine  prints 
an  error  message  and  returns  with  no  action. 


When  in  the  stab  vector  command  mode,  an  attempt  is  made  to  align  the  base  vector  with 
the  stab  vector  then  rotate  each  node  away  from  the  stab  vector  by  some  offset  angle.  The 
offset  for  all  affected  nodes  is  set  to  zero  when  this  command  mode  is  entered  from  some 
other  command  mode  or  if  coords  changes.  The  offset  for  an  element  can  be  set  using  the 
routine  rotate_modify_stab_offset(). 


When  dynamics  are  turned  on,  the  desired  angle  is  the  angle  which  would  align  the  base 
vector  with  the  stab  vector  plus  the  offset  The  difference  between  consecutive  desired 
angles  is  the  desired  rate.  When  this  command  mode  is  entered  from  another  mode  or 
when  the  value  of  coords  changes,  the  desired  rate  will  be  zero. 
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If  this  routine  is  called  every  dck,  the  desired  rate  will  be  as  described  above.  If  it  is  called 
while  in  diis  command  mode  but  it  was  not  called  during  the  previous  tick,  the  desired  rate 
will  be  reset  to  zero.  The  assumption  is  that  the  stab  vector  could  be  changing  continously 
and  that  this  routine  would  be  called  every  tick  to  reflect  this  change.  The  difference 
between  consecutive  desired  angles  would  be  an  appropriate  measure  of  desired  rate  in  this 
case. 

If  this  routine  is  not  called  every  tick,  it  is  assumed  that  the  stab  vector  is  not  changing 
continously.  When  the  routine  is  called,  the  new  stab  vector  is  not  assumed  to  be  associated 
with  the  previous  stab  vector  and  the  desired  rate  is  set  to  zero. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

stab_vector 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

coords 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.16.2  librotate.h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

parent 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

child 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Errors  1 

Error 

Reason  for  Error 

ROTATE:  rotate  set  stab  vector 

tryinq  to  stabilize  inappropriate  class 

1  Calls  1 

Function 

Where  Described 

vec  normalize 

Section  2.6.2.63.1 

Table  2.5-371;  rotate  set  stab  vector  in  coordinates  Information. 
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2.5.18.4.24  rotate_set_stab_current_position 

This  routine  finds  the  current  position  of  the  base  vector  in  world  coordinates  and  uses  it  to 
set  the  stab  vector. 


Parameters 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

Calls 

Function 

Where  Described 

rotate_set_stab_currentj30Sition_in_ 

coordinates 

Section  2.5.18.4.25 

Table  2.5-372;  rotate_set_stab_current_position  Information. 


2.5.18.4.25  rotate_set_stab_current_position_in_coordinates 
element  -  A  pointer  to  the  element  of  interest. 

coords  —  A  pointer  to  the  element  in  whose  coordinates  the  base  vector  is  to  be 

expressed. 

This  routine  finds  the  current  position  of  the  base  vector  in  coordinates  of  coords  and  uses 
it  to  set  the  stab  vector.  If  the  element  is  not  in  a  stab  class,  an  error  message  is  printed. 

_ _ Parameters _ _ 

Parameter _ Type _ Where  Tvpedef  Declared 

element  pointer  to  Section  2.5.18.2  librotate.h 

_  ROTATE  ELEMENT _ 

coords  pointer  to  Section  2.5.18.2  librotate.h 

 ROTATE  ELEMENT 


_  Internal  Variables  _ 

Variable _ Type _ Where  Typedef  Declared 

child  pointer  to  Section  2.5.18.2  librotate.h 

_ ROTATE  ELEMENT _ 

stab_vector  VECTOR  /simnetycommon/include/glob 

al/sim  types. h 


_ Errors _ 

Error  Reason  for  Error 

ROTATE:  rotate  set  current  position  stab  trying  to  stabilize  inappropriate  class 

Calls 

Function _ Where  Described _ 

vec  mat  mul _ Section  2.6.2.56.1 _ 

rotate  get  mat _ ^ _  Section  2.5.18.5.5 _ 

rotate  set  stab  vector  in  coordinates  Section  2.5.18.4.23 

Table  2.5-373:  rotate  set  stab  current  position  in  coordintates 

Information. 
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2.5.18.4.26  rota  te_set_sta  b_point 

element  -  A  pointer  to  the  element  of  interest. 

stab  j)oint  -  A  pointer  to  a  vector  which  stores  the  location  at  which  the  base  vector 
should  point.  The  point  is  expressed  in  meters  in  world  coordinates. 

This  routine  sets  the  stab  point  which  is  expressed  in  world  coordinates.  It  calls  the  more 
general  routine  rotate_set_stab_point_in_coordinates()  to  set  the  vector. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  iibrotate.h 

stabjaoint 

VECTOR 

/simnet/common/inciude/giob 
al/sim  types. h 

1  Calls  1 

■  Function  1 

Where  Described 

Section  2.5.18.4.27 

■  world 

Section  2.5.18.6.8 

Table  2.5-374:  rotate_set_stab_point  Information. 
2.5.18.4.27  rotate_set_stab_point_in_coordinates 


element 
stab j)oint 

coords 


A  pointer  to  the  element  of  interest. 

A  pointer  to  a  vector  which  stores  the  location  at  which  the  base  vector 
should  point.  The  point  is  expressed  in  meters  in  the  coordinates  of  coords. 
A  pointer  to  the  element  in  whose  coordinates  the  stab  point  is  expressed. 


This  routine  sets  the  point  to  which  the  base  vector  of  a  family  or  orphan  is  to  point.  This 
point  is  in  the  coordinates  of  element  coords,  coords  should  be  moved  before  element  by 
calling  rotate_prioritize_eIements()  except  when  this  routine  is  called  from 
rotate_set_stab_point(),  since  the  world  is  always  fixed. 

This  routine  sets  the  command  mode  of  element,  and,  if  it  is  in  a  stab  family,  sets  its  other 
family  member.  If  element  is  not  in  a  stab  family  or  is  not  a  stab  orphan,  this  routine  prints 
an  error  message  and  returns  with  no  action. 

When  in  the  stab  point  command  mode,  an  attempt  is  made  to  point  the  base  vector  at  the 
stab  point  then  rotate  each  node  away  from  the  stab  point  by  some  offset  angle.  The  offset 
for  all  affected  nodes  is  set  to  zero  when  this  command  mode  is  entered  from  some  other 
command  mode  or  if  coords  changes.  The  offset  for  an  element  can  be  set  using  the 
routine  rota t e_mod if y _sta b_of f set ( ). 

When  dynamics  are  turned  on,  the  desired  angle  is  the  angle  which  would  point  the  base 
vector  at  the  stab  point  plus  the  offset.  The  differance  between  consecutive  desired  angles 
is  the  desired  rate.  When  this  command  mode  is  entered  from  another  mode  or  when  Ae 
value  of  coords  changes,  the  desired  rate  will  be  zero. 

If  this  routine  is  called  every  tick,  the  desired  rate  will  be  as  described  above.  If  it  is  called 
while  in  this  command  mode  but  it  was  not  called  during  the  previous  tick,  the  desired  rate 
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will  be  reset  to  zero.  The  assumption  is  that  the  stab  point  could  be  changing  continously 
and  that  this  routine  would  be  called  every  tick  to  reflect  this  change.  The  differance 
between  consecutive  desired  angles  would  be  an  appropriate  measure  of  desired  rate  in  this 
case. 

If  this  routine  is  not  called  every  tick,  it  is  assumed  that  the  stab  point  is  not  changing 
continously.  When  it  is  called,  the  new  stab  point  is  assumed  to  be  unassociated  with  the 
previous  stab  point  and  the  desired  rate  is  set  to  zero. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

stabjsoint 

VECTOR 

/simnet/common/include/glob 
al/sim  types. h 

coords 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

parent 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

child 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Errors  1 

Error 

Reason  for  Error 

ROTATE:  rotate  set  stab  point 

trvina  to  stabilize  inappropriate  class 

1  Calls  1 

Function 

Where  Described 

vec  COPY 

Section  2.6.2.59.1 

Table  2.5-375: 


rotate_set_stab_point_in_coordinates  Information. 
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2.5.18.4.28  rotate_set_stab_rate 

element  -  A  pointer  to  the  element  of  interest. 

rate  —  The  desired  rate  of  rotation  of  the  node  in  radians  per  tick. 

This  routine  causes  the  node  to  stabilize  in  the  world  and  turn  at  the  specified  rate  by  calling 
the  more  general  routine  rotate_set_stab_rate_in_coordinates(). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

rate 

REAL 

/simnet/commonyinclude/glob 
al/sim  types. h 

Calls 

Function 

Where  Described 

world 

Section  2.5.18.6.8 

rotate  set  stab  rate  in  coordinates 

Section  2.5.18.4.29 

Table  2.5-376:  rotate_set_stab_rate  Information. 

2.5.18.4.29  rotate_set_stab_rate_in_coordinates 

element  -  A  pointer  to  the  element  of  interest. 

rate  -  The  desired  rate  of  rotation  of  the  node  in  radians  per  tick. 

coords  -  A  pointer  to  the  element  in  whose  coordinates  the  element  is  stabilized. 

This  routine  causes  the  stab  family  or  orphan  to  stabilize  in  the  desired  coordinates  and  turn 
at  the  desired  rate.  When  this  command  mode  is  entered  from  another  command  mode  or 
when  the  coordinate  system  changes,  the  cument  location  of  the  base  vector  in  the 
coordinates  of  coords  is  determined  and  saved  as  the  stab  vector,  coords  should  be  moved 
before  element  by  calling  rotate_prioritize_eIements()  except  when  this  routine  is 
called  from  rotate_set_stab_rate(),  since  the  world  is  always  fixed. 

If  element  is  not  in  a  stab  family,  this  routine  prints  an  error  message  and  returns  with  no 
action. 

When  the  nodes  are  operated  on,  an  attempt  is  made  to  align  the  base  vector  with  the  stab 
vector  to  point  the  base  vector  in  its  original  direction.  Each  node  in  the  family  is  then 
turned  by  the  amount  specified  in  rate.  After  the  stab  orphan  or  both  members  of  the  stab 
family  have  been  mov^,  the  position  of  the  base  vector  in  coords  is  determined  and  saved 
and  the  process  repeats. 

When  this  command  mode  is  entered  from  another  mode  or  when  a  new  coordinate  system 
is  specified,  both  members  of  a  stab  family  enter  this  mode.  The  specified  rate  is  set  for 
element,  and  the  rate  for  the  other  member  of  the  family  is  set  to  zero.  Usually,  this  routine 
would  be  called  for  both  members  of  a  stab  family.  The  first  call  would  perform  all  the 
necessary  initialization  and  set  the  rate  of  the  node  specified  in  the  call.  The  second  call 
would  simply  set  the  rate  for  the  other  family  member.  Any  call  to  this  routine  which  does 
not  cause  a  transition  in  command  mode  or  does  not  specify  new  coordinates  simply  sets  a 
new  rate  for  the  specified  node. 
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The  action  of  this  tcommand  mode  when  dynamics  are  turned  on  is  very  similar  to  the  other 
stabilized  modes..  The  desired  angle  is  the  angle  which  will  align  the  base  vector  with  the 
stab  vector  plus  tfte  specified  rate.  The  desire^l  rate  is  not  rate,  but  is  the  difference  between 
consecutive  desiiesd  angles.  When  there  is  a  transition  into  this  command  mode  or  when 
new  coordinates  acre  specified,  the  desired  rate  is  set  to  zero.  Subsequent  calls  to  this 
routine  or  their  fiequency  do  not  affect  the  desired  rate. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

rate 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

coords 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

parent 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

child 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Errors  1 

Error 

Reason  for  Error 

rotate  set  stab  raha  in  coordinates 

tryina  to  stabilize  inappropriate  class 

1  Calls  1 

Function 

Where  Described 

vec  mat  mul 

Section  2.6.2.56.1 

rotate  qet  mat 

Section  2.5.18.5.5 

Table  2.5-377:  rotate  set  stab  rate  in  coordinates  Information. 


2.5.18.4.30  rotate  set  loc 


element  —  A  pointer  to  the  element  of  interest. 

location  ~  Thie  location  of  the  element  expressed  in  meters  in  its  parent’s  coordinates. 
This  routine  issuers  a  command  to  set  the  location  of  the  element. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

location 

VECTOR 

/simnet/common/include/giob 
al/sim  types. h 

Calls 

Function 

Where  Described 

vec  copy 

Section  2.6.2.59.1 

TabSe  2.5-378;  rotate  set  loc  Information. 
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2.5.18.4.31 


rotate_get_angle 


This  routine  returns  the  current  angle  (in  radians )  of  element  with  respect  to  its  parent. 
element  represents  a  pointer  to  the  element  of  interest. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Return  Values  1 

Return  Value 

Meanina 

element->anale 

REAL 

the  current  ancle  of  element 

Table  2.5-379:  rotate_get_angIe  Information. 
2.5.18.4.32  rotate_get_sin_angle 

This  routine  returns  the  sine  of  the  current  angle  of  element  with  respect  to  its  parent. 
element  represents  a  pointer  to  the  element  of  interest. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

element->sin_ang 

REAL 

the  sine  of  the  current  angle  of 
element 

Table  2,5-380:  rotate_get_sin_angle  Information. 
2.5.18.4.33  rotate_get_cos_angle 


This  routine  returns  the  cosine  of  the  current  angle  of  element  with  respect  to  its  parent. 
element  represents  a  pointer  to  the  element  of  interest. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

element->cos_ang 

REAL 

the  cosine  of  the  current  angle 
of  element 

Table  2.5-381:  rotate_get_cos_angle  Information. 
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2.5.18.4.34 


rotate_get_rate 


This  routine  returns  the  current  rate  of  rotation  of  element  with  respect  to  its  parent. 
element  represents  a  pointer  to  the  element  of  interest. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  iibrotate.h 

1  Return  Values  1 

Return  Value 

Meanina 

element->rate 

REAL 

the  current  rate  of  rotation  of 
element 

Table  2.5-382:  rotate_get_rate  Information. 
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2.5.18.5  rot_relate.c 

This  file  contains  routines  that  determine  and  maintain  the  relationships  between  coordinate 
systems;  these  routines  find  and  store  the  transformation  matrices,  location  vectors,  etc. 

The  coordinate  systems  are  one  of  the  characteristics  of  the  rotation  elements.  The  elements 
are  assigned  positions  within  a  hierarchal  tree  stmcture.  Connected  pairs  in  the  tree  have  a 
parent-child  relationship.  All  but  one  of  the  elements  has  a  single  parent  and  may  have  one 
or  more  children.  The  top  element  in  the  tree  is  always  the  world  and  has  no  parent. 

This  file  contains  the  transformation  element  definition.  An  array  of  transfonnation 
elements  is  declared  with  an  entry  for  each  node  pair.  An  element  contains  the  information 
needed  to  determine  and  maintain  the  transformation  between  the  nodes.  Some  of  the 
members  of  this  structure  make  use  of  the  fact  that  each  of  the  nodes  are  assigned  a  number 
with  the  number  of  a  parent  always  being  lower  than  the  number  of  any  of  its  children. 

The  transform_element  structure  is  defined  with  the  following  members: 


exists 


value 


requests 

product 


test 

link 


matrixexists 

matrix 

transpose  exists 
transpose 


—  TRUE  if  the  transformation  from  one  of  the  nodes  to  the  other  is 
known  or  can  be  obtained  directly  from  rotation  element 
information,  and  FALSE  otherwise. 

—  The  value  of  this  transformation.  The  value  is  based  on  the 
number  and  rate  of  requests  for  the  transformation  from  one  of  the 
nodes  to  the  other. 

—  The  number  of  requests  made  during  the  current  time  step. 

—  If  the  nodes  associated  with  this  element  are  not  a  parent  and  child, 
this  transformation  can  be  found  by  multiplying  two  other 
matrices  (which  may  or  may  not  currently  exist)  together.  For 
example,  if  this  element  is  associated  with  the  transformation 
betweens  nodes  4  and  7,  then  the  transformation  can  be  found  by 
multiplying  the  transformations  between  nodes  4  and  2  and  nodes 
2  and  7.  T^e  number  of  the  optimal  intermediate  node  (2  in  this 
example)  is  stored  here. 

"  The  number  of  a  potential  intermediate  node. 

—  If  the  associated  nodes  are  a  parent  and  child,  link  is  a  pointer  to 
the  child.  If  not,  link  is  a  null  pointer.  If  this  is  a  parent-child  pair 
(not  null),  this  transformation  always  exists. 

”  TRUE  if  the  transformation  from  the  lower  numbered  node  to  the 
higher  has  been  determined,  and  FALSE  otherwise. 

—  The  transformation  matrix  from  the  lower  numbered  coordinate 
system  to  the  higher. 

—  TRUE  if  the  transformation  from  higher  numbered  node  to  the 
lower  has  been  determined,  and  FALSE  otherwise. 

”  The  transformation  matrix  from  the  higher  numbered  coordinate 
system  to  the  lower. 
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This  file  contains  the  location  element  definition.  An  element  contains,  or  has  the 
infonnation  necessary  to  determine,  the  location  of  one  node  with  respect  to  another.  The 
location  is  expressed  in  the  originating  node's  coordinate  system.  For  example,  the 
location  of  7  with  respect  to  4  is  the  vector  from  4  to  7  expressed  in  4's  cooidinate  system. 
An  array  of  these  elements  is  declared  with  an  entry  for  each  directed  node  pair,  for 
example,  there  is  an  entry  for  7  with  respect  to  4  and  another  entry  for  4  with  respect  to  7. 
The  location_element  structure  is  defined  with  the  following  members: 


exists 

value 

requests 

inverse 


matrix 

vector 


-  TRUE  if  the  location  is  known,  and  FALSE  otherwise. 

-  The  value  of  this  location.  The  value  is  based  on  the  number  and 
frequency  of  requests  made. 

-  The  number  of  requests  for  this  location  made  during  the  current 
time  step. 

--  The  index  of  the  inverse  location.  If,  for  example,  this  location  is 
7  with  respect  to  4,  this  is  index  of  the  location  element  of  4  with 
respect  to  7. 

-  The  index  into  the  transformation  array  of  the  transformation 
between  the  nodes  associated  with  this  element. 

-  The  location  vector. 


This  file  contains  the  path  search  tree_element  definition.  These  types  of  elements  are  used 
in  finding  the  shortest  and  most  valuable  path  from  one  node  to  another.  All  the  potential 
paths  are  stored  in  a  tree  structure  and  the  tree  is  built  one  generation  at  a  time,  llie 
tree_element  structure  is  defined  with  the  following  members: 


patera  --  The  element  immediately  preceding  this  element  in  the  potential 

path. 

cousin  -  The  next  element  in  this  generation  of  potential  path  nodes. 

irulex  --  The  number  of  the  node  associated  with  this  element.  Used  to 

index  into  the  node  status  array. 

This  file  contains  the  break  element  definition.  These  types  of  elements  are  used  to  build 
lists  of  transformation  or  location  elements  that  are  inviidated  when  the  position  or 
orientation  of  a  rotation  node  changes.  The  lists  are  linked  lists.  The  break_element 
structure  is  defined  with  the  following  member: 

next  —  The  next  element  in  the  list. 

index  -  The  index  to  the  element  in  the  transformation  or  location  array 

which  is  invalidated. 


VALUE_DECAY_FACTOR  is  defined  as  the  percentage  of  previous  value  added  to  the 
current  number  of  requests  to  determine  the  new  value. 


Declarations: 


node_count 

-  The 

node_count_minus_  1 

-  The 

transform_count 

-  The 

location_count 

--  The 

num_tree_nodes 

-  The 

number  of  nodes, 
number  of  nodes  minus  1. 
number  of  transform  elements, 
number  of  location  elements, 
number  of  reserved  tree  elements. 
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To  allow  for  any  number  of  nodes,  much  of  the  needed  memory  is  dynamically  allocated. 
The  following  pointers  to  this  memory  are  set  to  ROTATE_NULL  at  compile  time  to  show 
that  no  memory  is  associated  with  them. 

node_status  --  An  indication  of  the  availability  of  a  node  in  a  search  path  is 

stored  in  an  array  pointed  to  by  node  status.  There  is  one 
entry  for  each  node.  If  the  entry  is  TRUE,  the  node  is 
available,  and  FALSE  if  not 

mul_path  “  The  order  of  transformation  multiplications  is  stored  as  an 

ordered  list  of  nodes  in  mul _path.  The  longest  possible  path 
would  include  each  node  once. 


transform_list  is  declared  as  the  array  of  transform  elements. 
location_list  is  declared  as  the  array  of  location  elements. 
tree_list  is  declared  as  the  array  of  tree  elements. 

node_transform_break  is  declared  as  an  array  of  pointers  to  break  elements.  The  array  has 
an  entry  for  each  node  and  each  entty  points  to  the  beginning  of  a  linked  list  of  break 
elements.  Each  element  in  a  list  indicates  a  transformation  that  is  invalidated  when  the 
orientation  of  the  associated  node  is  changed. 

node_location_break  is  declared  as  a  similar  array  of  pointers.  The  linked  lists  associated 
with  each  node  indicate  the  locations  that  are  inviidated  when  the  node  changes  its 
orientation  or  position  with  respect  to  its  parent. 

node_location_break_ends  is  declared  as  a  similar  array  of  pointers.  The  linked  lists 
associated  with  each  node  indicate  the  locations  that  are  invalidated  when  the  node  changes 
its  position  with  respect  to  its  parent  but  not  when  the  orientation  is  changed. 


The  following  static  functions  are  declared: 

rotate_number_node() 

rotate_fill_permanent_tree() 

rotate_rind_transforiii^path() 

rotate_path_val() 

rotate_save~path() 

rotate^natd 

rotate~transform_index() 

rotateJocation_index() 

dump_transform() 

dumpJocationO 

dump~break_list() 

2.5.18.5.1  rotate_relate_init 

This  routine  performs  the  initialization  tasks  related  to  the  tracking  of  the  relationships 
between  nodes.  In  order  to  handle  rotation  trees  of  any  size,  much  of  the  memory  used  is 
allocated  dynamically.  This  routine  manages  this  memory  and  initializes  a  number  of 
variables.  Internal  variables  are  represented  as  follows: 
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i 

cMldnode 

fh^m 

to 

traaniformjndex 
loaationindex 
current  break 


—  A  counter. 

~  The  child's  node  number  in  a  parent-child  pair. 
“  The  first  node  in  a  path. 

“  The  last  node  in  a  path. 

—  An  index  into  the  transform  list. 

~  An  index  into  the  location  list 
~  A  pointer  to  a  break  element 


The  pointers  to  the  blocks  of  menory  that  are  dynamically  allocated  are  initialized  to 
ROTA'IE_NULL  in  the  compi&er.  If  the  simulation  has  been  previously  initialized  during 
tite  executoon  of  the  simulation  software,  the  pointers  are  no  longer  ROTATE_NULL  but 
point  to  tine  memory  last  allocasted.  Any  previously  allocated  memory  is  freed. 

Three  graeips  of  break  elements  exist.  Within  each  group,  a  linked  list  of  break  elements  is 
associat»J  with  each  node.  For  each  group,  this  memory  is  freed  by  following  each  list  to 
fice  each  break  element  and  tiheo  freeing  the  array  of  pointers  for  the  group. 


The  node  count  to  is  set  to  zero,  and  the  nodes  are  numbered.  The  world  will  be  node  zero 
and  each  pnarent  will  have  a  mnaiber  lower  than  any  of  its  children.  When  the  numbering  of 
nodes  is  completed,  node  couae  will  contain  the  total  number  of  nodes.  This  allows 
node  count  minus  1  to  be  foomd. 


The  number  of  combinations  €J<f  k  items  out  of  n  items  is  n!/(k!(n-k)!).  In  this  case,  we  are 
interested  an  the  number  of  node  pairs,  so  k  =  2.  TTie  number  of  pairs  then  becomes 
ti!(n-l)^.  tranrform_count  is  set  to  this  value  and  transform  count  +  1  transform  elements 
are  allocated.  The  extra  element  is  used  to  represent  the  transformation  of  any  node  to 
itself. 

Each  ordeml  pair  has  a  location  element,  therefore  there  are  twice  as  many  location 
elements  as  transform  elements,  location  count  is  set  and  location  count  +  1  location 
elements  are  allocated.  The  extra  element  is  used  to  represent  the  location  of  a  node  with 
respect  to  Ktself.  node  status  and  mul _par/i  are  allocated,  num  tree  nodes  is  found  and 
treejist  is  allocated,  nodejrtmsform  break,  node  location  break  and 
node  jocaiion  break  ends  are  allocated 

Each  entry  of  each  of  the  break  arrays  is  filled  with  ROTATE_NULL.  This  indicates  that 
no  linked  lists  have  been  formed  yet. 

The  initialization  for  each  node  pair  is  first  performed.  The  indices  into  tranrform  list  and 
locationjist  are  found  and  each  of  the  elements  in  the  entries  are  initialized.  The  location 
list  entry  for  the  inverse  location  is  initialized.  The  extra  entries  in  transformjist  and 
location  jist,  for  transformation  from  a  node  to  itself,  are  initialized.  Note  that  the 
location  list  extra  entry  is  its  own  inverse  and  that  it  points  to  the  extra  entry'  in  the 
tranrform  list. 

The  identi  ty  matrix  is  stored  as  die  transformation  matrix.  Even  though  the  matrix  has  been 
filled  in,  the  existence  flag  for  diis  transformation  is  still  set  FALSE. 

A  zero  length  vei;tor  i.s  stored  ais  the  location  vector  Even  though  the  vector  has  been  filled 
in,  the  exirstence  flag  lor  this  Uxat  n  is  still  set  FALSE. 


The  entries  in  the  transform  an<J  legation  lists  that  repre  ;ent  links  between  parents  and 
children  iiTi  the  rouitc  ode  tree  ?  >  jund.  These  e  mie'' permanently  exist  and  that 
existence  i  s  flagged 
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Break  lists  are  built  by  looping  through  every  node  pair. 

The  index  into  the  transform  list  is  found  and  tested  for  existence  of  the  transform.  If  it 
exists  (that  is,  if  the  two  nodes  are  a  parent-child  pair)  the  next  node  pair  is  tested. 

The  path  between  the  nodes  is  found.  The  only  transform  elements  that  currently  exist  are 
those  that  represent  parent-child  pairs,  the  transforms  that  permanently  exist  This,  along 
with  the  fact  that  no  loops  exist  in  the  node  tree,  means  that  there  is  only  one  path  tetween 
the  nodes  and  that  it  only  contains  transformations  between  parents  and  children.  The  path 
(which  is  stored  in  mul _path  as  a  list  of  nodes)  is  followed  tom  the  beginning  to  the  end. 

Each  consecutive  pair  of  nodes  in  mul _path  is  a  parent  child  pair.  The  larger  node  number 
is  the  child.  Since  each  child  has  only  one  parent,  changing  the  transformation  or  location 
between  a  parent  and  child  can  be  viewed  as  changing  the  orientation  or  position  of  the 
child.  The  child  node  is  found  and  incremented  i.  The  while  loop  construction  allows  each 
node  pair  to  be  processed. 

If  the  child's  orientation  is  changed,  the  transformation  between  the  from  and  to  nodes  (if 
it  exists)  is  invalidated.  A  break  element  is  constructed  for  the  from-to  transformation  and 
placed  at  the  beginning  of  the  transform  break  list  for  the  child  node. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

child  node 

int 

Standard 

from 

int 

Standard 

to 

int 

Standard 

transform  index 

int 

Standard 

location  index 

int 

Standard 

current_break 

pointer  to  the  structure 
break  element 

Section  2.5.18.5  rot_relate.c 

1  Errors  1 

Error 

Reason  for  Error 

LIBROTATE(rotate_relate_init) :  FATAL 

cannot  allocate; 

transformjist 

locationjist 

node_status 

mul_path 

treejist 

node_transform_break 
nodeJocation_break 
node  location  break  ends 

1  Calls  1 

Function 

Where  Described 

rotate  number  node 

Section  2.5.18.5.2 

world 

Section  2.5.18.6.8 

rotate  transform  index 

Section  2.5.18.5.11 

rotate  location  index 

Section  2.5.18.5.14 

mat  ident 

Section  2.6.2.43.1 

vec  init 

Section  2.6.2.61.1 

1285 


BBN  Systems  and  Technologies 


Vehicles  CSC! 


■  rotate  fill  permanent  tree 

Section  2.5.18.5.3 

1  rotate  find  transform  path 

Section  2.5.18.5.6 

Table  2^^383:  rotate_relate_init  Information. 
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2.5.18.5.2  rotate_number_node 

This  routine  assigns  a  number  to  the  node  specified  in  the  rotation  element,  element.  A 
pointer  to  the  world  node  is  passed  into  the  first  call  to  this  routine.  It  then  numbers  each 
of  the  nodes  in  the  tree  recursively.  Because  of  the  order  in  which  functions  are 
performed,  the  number  of  a  parent  is  always  less  than  the  number  of  any  of  its  children. 
After  all  the  nodes  have  been  numbered,  node  count  contains  the  total  number  of  nodes. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

Internal 

Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

rotate  number  node 

Section  2.5.18.5.3 

Table  2.5-384: 


rotate_number_node  Information. 
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2.5.18.5.3  rotate_fill_permanent_tree 

This  routine  sets  the  existence  flag  of  the  transform  between  the  element  and  its  parent  and 
the  location  of  the  element  with  respect  to  its  parent.  It  also  fills  in  the  information  linking 
the  transform  and  location  elements  to  the  rotate  element.  This  routine  calls  itself 
recursively  after  a  pointer  to  the  world  is  passed  in  the  first  call.  No  assignments  are  made 
when  element  represents  the  world. 

The  index  into  the  transform  list  for  the  transfcnm  between  this  element  and  its  parent  is 
found  and  stored  in  the  element  structure.  The  existence  of  this  transform  is  indented  and  a 
pointer  to  the  rotate  element  is  stored. 

The  index  into  the  location  list  for  the  location  of  the  element  with  respect  to  its  parent  is 
found  and  saved  in  the  element  structure.  The  existence  of  this  location  is  indicated.  Note 
that  the  location  of  the  element  with  respect  to  its  parent  permanently  exists,  however,  the 
location  of  the  parent  with  respect  to  the  element  does  not  The  location  of  the  element  with 
respect  to  its  parent  may  only  be  changed  explicitly;  the  values  in  the  location  vector  change 
although  it  remains  a  viid  location.  U  the  element  changes  its  orientation  with  respect  to  its 
parent,  the  location  of  the  parent  with  respect  to  the  element  is  no  longer  valid  and  must  be 
determined. 

The  existence  of  the  links  to  all  of  the  element's  children  are  then  established. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

index 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

rotate  transform  index 

Section  2.5.18.5.11 

rotate  location  index 

Section  2.5.18.5.14 

Section  2.5.18.5.3 

rotate_fllI_permanent_tree  Information. 
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2.5.18.5.4  rotate_relate_siinul 

This  routine  updates  the  values  of  the  transform  and  location  elements.  This  routine  is  the 
only  libtotate  routine  which  requires  a  knowledge  of  the  passage  of  time. 

The  transform  list  is  updated  by  finding  a  new  value  from  the  sum  of  the  number  of  request 
made  during  the  current  tick  and  a  fraction  of  the  current  value.  The  request  count  is  then 
zeroed.  If  Ae  number  of  requests  made  per  tick  is  constant,  then  the  new  value  of  the 
transform  will  be  less  than  (requests  /  (1  -  VALlJE_DECAY_FACTOR)};  if  the  number  of 
requests  made  in  a  tick  is  bounded,  then  the  value  is  bounded. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.5-386: 


rotate  relate  simul  Information. 
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US  .18.5.5  rotate_get_mat 


Iftds  routine  finds  a  transformation  matrix  between  coordinate  systems.  If  this  matrix  is 
pro-multiplied  by  a  vector  expressed  in  from  coordinates,  the  result  is  the  same  vector 
oripressed  in  to  coordinates.  The  routine  returns  a  pointer  to  the  desired  transformation 
Bsstrix.  Parameters  and  variables  are  represented  as  follows: 


ftmm  —  A  pointer  to  a  rotate  element  fiom  whose  coordinate  system  a  transformation 
is  desired. 

ui>  -  A  pointer  to  a  rotate  element  to  whose  coordiante  system  a  transformation  is 

desired. 

imdex  —  The  index  of  the  transform  element. 


Krst  the  routine  calculates  index.  Note  that  if  index  is  equal  to  transform  count,  a 
mmsfoimation  from  a  node  to  itself  has  been  guested.  In  this  case  the  identity  matrix  is 
imnned.  Otherwise,  the  transformation  matrix  is  determined  and  the  requests  counter  is 
inopemented. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

franm 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

to 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Internal  Variables  1 

VaTlable 

Where  Typedef  Declared 

ineiex 

int 

Standard 

1  Return  Values  1 

Raturn  Value 

Meaning 

transform  listfindexl. matrix 

T  MAT  PTR 

a  pointer  to  the  identity  matrix 

ra^te_mat 

(l«Dm->rotate_node, 

IO'  >rotate  node) 

T_MAT_PTR 

a  pointer  to  the  transfomnation 
matrix 

1  Calls  i 

Ftunctlon 

Where  Described 

rateate_transform_index 

Section  2.5.18.5.11 

rotrate  find  transform  path 

Section  2.5.18.5.6 

Table  2.5-387: 


rotate_get_mat  Information. 
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2.5.18.5.6  rotate_nnd_transform_path 

This  routine  determines  the  path  on  the  tree  between  the  given  nodes  from  and  to. 
Parameters  are  represented  as  follows; 

from  —  A  pointer  to  the  node  number  from  which  the  path  starts. 

to  -  A  pointer  to  the  node  number  to  which  the  path  ends. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

trom 

int 

Standard 

to 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

i 

int 

Standard 

i 

int 

Standard 

tree  index 

int 

Standard 

deoth 

int 

Standard 

path  not  found 

int 

Standard 

vat 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

path_val 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

generation 

pointer  to  structure 
tree  element 

Section  2.5.18.5  rot_relate.c 

search 

pointer  to  structure 
tree  element 

Section  2.5.18.5  rot_relate.c 

temp_element 

pointer  to  structure 
tree  element 

Section  2.5.18.5  rot_relate.c 

1  Errors  1 

Error 

Reason  for  Error 

LiBROTATE(rotate  find  transformjaath): 
FATAL 

Exhausted  tree  elements 

LIBROTATE(rotate  find  transformjaath): 
FATAL 

Exhausted  connections 

1  Calls  1 

Function 

Where  Described 

rotate  path  val 

Section  2.5.18.5.7 

rotate  save  path 

Section  2.5.18.5.8 

Table  2.5>388:  rotate_find_transform_path  Information. 
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2.5.18.5.7  rotate_path_val 


This  routine  returns  the  path  value  of  a  path  of  a  specified  length.  Parameters  are 

represented  as  follows: 

pah  -  the  path  of  interest. 

length  —  the  length  of  path. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

oath 

an  array  of  int 

Standard 

lenath 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

index 

int 

Standard 

current_val 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

new_val 

REAL 

/simnet/common/include/giob 
al/sim  types. h 

1  Return  Values  1 

Return  Value 

Meaning 

0.0 

REAL 

no  path  exists 

current_val  + 

transform  listlindexl.value 

REAL 

the  value  of  the  specified  path 

1  Calls  1 

Function 

Where  Described 

rotate,  path  val 

Section  2.5.18.5.7 

rotate  transform  index 

Section  2.5.18.5.11 

Table  2.5-389: 


rotate_path_vaI  Information. 
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2.5.18.5.8  rotate_save_path 

This  r  jutine  saves  the  tree  path  between  the  node  numbered  from  to  the  node  numbered  to. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

from 

int 

Standard 

to 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

index 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

rotate  transform  index 

Section  2.5.18.5.11 

rotate  save  path 

Section  2.5.18.5.8 

Table  2.5-390:  rotate_save_path  Information. 

2.5.18.5.9  rotate_niat 

This  routine  finds  a  transformation  matrix  between  coordinate  systems.  If  this  matrix  is 
pre-multipiicd  by  a  vector  expressed  in  from  coordinates,  the  result  is  the  same  vector 
expressed  in  to  coordinates. 

from  -  The  number  of  the  node  from  whose  coordinate  system  a  transiormation  is 
desired. 

to  -  The  number  of  the  node  to  whose  coordiante  system  a  transformation  is 

desired. 

index  -  The  index  of  the  transform  element  associated  with  this  node  pair. 

link  ”  A  pointer  to  the  child's  rotate  element  for  a  parent-child  pair. 

The  routine  first  determines  index.  The  routine  then  determines  if  the  transformation 
exists.  A  transformation  exists  if  the  transformation  or  its  transpose  has  been  found,  or  if 
the  transformation  is  associated  with  a  parent-child  pair  and  can  be  generated  directly. 

There  is  one  transformation  for  each  node  pair. 

First  the  routine  determines  if  the  transformation  exists.  There  is  one  transformation 
element  for  each  node  pair.  If  the  value  of  from  is  less  than  to,  then  the  matrix  associated 
with  this  transformation  is  desired.  If  the  matrix  does  not  exist,  it  is  generated  either  from 
the  transpose  or  from  a  defined  parent-child  link.  If  the  value  of  from  is  greater  than  to,  the 
transpose  of  the  transformation  matrix  is  desired.  If  this  transpose  does  not  exist,  it  must 
be  generated  from  the  matrix.  If  the  matrix  does  not  exist,  the  transpose  can  be  generated 
from  a  defined  parent-child  link .  Once  the  matrix  is  found,  its  existence  is  flagged  and  a 
pointer  to  the  transpose  is  returned.  If  neither  the  transformation  or  the  matrix  can  be 
found,  an  error  is  indicated.  If  the  value  of  from  equals  to,  a  request  for  the  transformation 
of  a  node  to  itself  has  been  made.  This  is  an  error  condition.  The  error  is  indicated  and  the 
identity  matrix  is  returned. 

If  the  transformation  does  not  exist,  it  must  be  generated  by  matrix  multiplication.  If  from 
is  less  than  to,  the  matrix  is  generated  by  multiplying  the  transformation  from  the  from 
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node  to  the  product  node  by  the  transformation  from  the  product  node  to  the  to  node.  The 
existence  of  the  transformation  and  the  matrix  are  flagged  and  a  pointer  to  the  matrix  is 
returned.  If from  is  greater  than  to,  the  transpose  is  desired.  The  transpose  is  generated  by 
multiplying  the  transformation  from  the/ro/n  node  to  the  product  node  by  the 
transformation  from  the  product  node  to  the  to  node.  The  existence  of  the  transformation 
and  the  matrix  are  flagg^  and  a  pointer  to  the  transpose  is  returned.  If  the  value  of  from 
equals  to,  a  request  for  the  transformation  of  a  node  to  itself  has  been  made.  This  is  an 
error  condition.  The  error  is  indicated  and  the  identity  matrix  is  returned. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

from 

int 

Standard 

to 

int 

Standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

link 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

transform  listfindexl. index 

T  MAT  PTR 

the  transformation  matrix 

transformjistfindexj. 

transpose 

T_MAT_PTR 

the  transformation  transpose 

transform  listfindexl. matrix 

T  MAT  PTR 

the  transformation  matrix 

1  Errors  1 

Error 

Reason  for  Error 

LIBROTATEfroLmat): 

FATAL  -  Cannot  form  matrix 

FATAL  -  Cannot  form  transpose 

WARNING  -  Dummy  matrix  exists? 

WARNING  -  Requesting  transform  from  node 
to  itself 

1  Calls  1 

Function 

Where  Described 

mat  transpose 

Section  2.6.2.51.1 

mat  fonn 

Section  2.6.2.42.1 

mat  mat  mul 

Section  2.6.2.32.1 

rotate  mat 

Section  2.5.18.5.9 

rotate  transform  index 

Section  2.5.18.5.11 

Table  2.5-391:  rotate  mat  Information. 
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2.5.18.5.10 


rotate  set  transform 


This  routine  is  called  when  the  transformation  between  a  parent  and  child  is  set  directly.  It 
is  called  from  rotate_exec()  in  "rot_util.c".  It  takes  element,  a  pointer  to  a  rotate  element, 
as  a  parameter. 


The  matrix  is  copied  from  the  rotate  element  into  the  transform  element,  and  the  flag  is  set 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Calls  1 

Function 

Where  Described 

mat  copy 

Section  2.6.2.39.1 

Table  2.5<392:  rotate  set  transform  Information. 
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2.5.18.5.11 


rotate  transform  index 


This  routine  returns  the  index  into  transformjist  for  a  node  pair.  Parameters  are 
represented  as  follows: 


from  -  The  number  of  the  first  node  of  the  pair. 

to  "  The  number  of  the  second  node  of  the  pair. 


One  transfiomation  element  exists  for  each  nocb  pair,  i.e.  the  transformation  fiom  node  4 
to  node  7  uses  the  same  element  as  the  transformation  from  node  7  to  node  4.  One  element 
is  used  for  all  transformations  from  any  node  to  itself.  The  memory  for  the  elements  is 
allocated  at  initalization.  This  routine  provides  a  way  to  access  a  transformation  element 
given  the  node  pair. 


Consider  the  case  where  there  are  N  nodes  numbered  0  to  N-1.  All  possible 
transformations  can  be  represented  as  elements  of  an  array  N  by  N.  The  rows  represent  the 
node  the  transformation  is  from  and  the  columns  represent  the  node  the  transformation  is 
to.  The  elements  below  the  diagonal  are  transposes  of  the  elements  above  the  diagonal,  so 
memory  is  not  allocated  for  them.  The  elements  on  the  diagonal  represent  a  transformation 
from  a  node  to  itself.  The  last  transformation  element  on  the  list  is  allocated  for  all  of  these 
transformations.  The  remaining  elements  are  then  stored  row-wise.  The  element 
represented  by  row  0  column  1  has  an  index  of  0  in  the  transformation  list,  row  0  column  2 
has  index  1,  continuing  to  row  0  column  (N-1)  which  has  index  N-2.  The  next  row 
follows,  i.e.  row  1  column  2  has  index  N-1. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

from 

inf 

Standard 

to 

int 

Standard 

1  Return  Values  1 

■  Return  Value  1 

Type 

Meaning 

int 

the  transformjist  index  if  a 
matrix  pair  is  given 

to  •  node  count  +  from  - 

(tO  +  1)*(tO  +  2)/2 

int 

the  transformjist  index  if  a 
transpose  pair  is  given 

transform_count 

int 

the  index  of  the  identity 
element 

Table  2.5-393: 


rotate  transform  index  Information. 


i 
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2.5.18.5.12  rotate_get_loc 

This  routine  finds  the  location  of  the  origin  of  the  to  element  coordinate  system  relative  to 
the  origin  of  the  from  element  coordinate  system  expressed  in  from  element  coordinates. 
Parameters  and  variables  are  represented  as  follows: 

fromelement 

tojelement 
from 
to 

testjrom 
testto 
mainjndex 
index 
lastjndex 
tempjndex 
i 

J 

length 

tempjfector 

First,  and  to,  and  main  jndex  are  found.  If  the  request  is  for  the  location  of  a  node 

with  respect  to  itself  or  for  a  location  that  has  already  been  determined,  the  pointer  to  the 
location  vector  is  returned. 

The  inverse  of  the  requested  vector  is  the  location  of  the  from  coordinate  system  relative  to 
the  to  coordinate  system  expressed  in  to  coordinates.  The  requested  location  is  then  the 
negative  of  the  inverse  times  the  transformation  from  to  coordinates  to  from  coordinates. 

length  is  found.  The  path  length  for  any  location  that  permanently  exists  and  its  inverse  is 
0.  All  other  path  lengths  must  be  greater  or  equal  to  3.  If  the  path  length  of  the  requested 
location  is  less  than  3  (i.e.  length  is  less  than  2),  an  error  inthcation  is  made. 

Consider  the  following  case.  The  location  of  node  4  with  respect  to  node  0  is  requested; 
from  is  0  and  to  is  4.  The  path  between  them  is  {0, 1, 2,  3, 4).  The  path  length  is  5  and 
length  is  equal  to  4.  The  definition  of  a  path  essentially  states  that  the  location  or  inverse  of 
the  location  of  any  two  adjacent  nodes  in  the  path  exists  as  does  the  transformation  between 
any  two  adjacent  nodes.  Assuming  that  no  other  locations  are  known,  the  transformation 
between  two  nodes  will  be  expressed  as  a_C_b,  for  example,  the  transformation  from  4  to 
3  is  4_C_3.  The  location  is  expressed  as  a_v_b.  for  example,  the  location  of  3  with  respect 
to  4,  expressed  in  4's  coordinates  is  4_v_3.  The  math  used  to  find  the  inverse  described 
above  would  then  be  3_v_4  =  -4_v_3  *  4_C_3.  For  the  example  request  0_v_4,  the 
following  steps  would  need  to  be  performed: 

3_v_4  permanently  exists. 

2_v_4  =  3_v_4  *  3_C_2  +  2_v_3 
2_v_4  =  2_v_4  *  2_C_1  +  l_v_2 
l_v_4  =  l_v_4  ♦  1_C_0  +  0_v_l 

Note  that  the  intermediate  results  are  generated  by  working  backwards  through  the  path. 
Using  the  example,  at  this  point  it  is  known  that  0_v_4  (or  4_v_0  and  4_C_0)  does  not 


~  A  pointer  to  the  rotate  element  which  is  the  reference  coordinate  system 
for  this  request. 

-  A  pointer  to  the  rotate  element  whose  location  is  requested. 

-  The  node  number  of fromjelement. 

-  The  node  number  of  to  element. 

--  An  intermediate  ^om  node  number 
--  An  intermediate  ro  node  number. 

-  The  index  into  the  location  list  of  the  from  to  to  node  pair. 

-  The  index  into  the  location  list  of  the  test  Jrom  to  to  node  pair. 

-  The  value  of  index  for  the  previous  pass  through  a  loop. 

-  The  index  into  the  location  list  of  the  test  Jrom  to  test  to  node  pair. 

--  A  counter. 

-  A  counter. 

-  The  number  of  elements  in  the  path  from  from  to  to  minus  1. 

-  A  vector  used  to  store  intermediate  results. 
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exist.  The  first  intermediate  result  that  exists  is  found  by  looping  forward  through  the 
path,  in  the  example,  check  to  see  if  l_v_4  or  2_v_4  or  3_v_4  exists. 

Even  if  the  desired  intermediate  result  may  not  exist,  its  inverse  and  appropriate 
transformation  may.  If  this  is  the  case,  the  intermediate  location  can  be  found.  For 
example,  2_v_4  does  not  exist  but  4_v_2  and  4_C_2  do.  2_v_4  =  4_v_2  *  4_C_2. 

If  the  location  of  the  next  adjacent  node  pair  exists,  the  next  intermediate  result  can  be 
found.  For  example,  2_v_4  was  found  in  the  last  pass.  l_v_2  exists.  The  next 
intermediate  result  is  l_v_4  =  2_v_4  *  2_C_1  +  l_v_2.  If  the  location  of  the  next  adjacent 
node  pair  does  not  exist,  its  inverse  does.  Find  the  next  intermediate  result  For  example, 
2_v_4  was  found  in  the  last  pass.  l_v_2  does  not  exist  but  2_v_l  does.  The  next 
intermediate  result  is  l_v_4  =  (2_v_4  -  2_v_l)  ♦  2_C_1. 

The  last  intermediate  result  found  is  actually  the  desired  location  and  a  pointer  to  it  is 
returned. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

from_element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

to_element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

from 

int 

Standard 

to 

int 

Standard 

index 

int 

Standard 

last  index 

int 

Standard 

temp  index 

int 

Standard 

i 

int 

Standard 

tree  index 

int 

Standard 

path  not  found 

int 

Standard 

current_vai 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

new_vai 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

temp_vector 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

aeneration 

Struct  tree  element 

Section  2.5.18.5  rot  relate.c 

search 

struct  tree  element 

Section  2.5.18.5  rot  relate.c 

temp  element 

stnjct  tree  element 

Section  2.5.18.5  rot  relate.c 

last  element 

struct  tree  element 

Section  2.5.18.5  rot  relate.c 

1  Return  Values  1 

Return  Value 

Meaning 

locationJist[location_count]. 

vector 

pointer  to  REAL 

/simnet/common/include/glob 
ai/'sim  types. n 

locationJist[index].vector 

pointer  to  REAL 

/simneVcommon/include/glob 
al/sim  tvpes.h 
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Errors 

Error 

Reason  for  Error 

LIBROTATE(rotate_getJoc) 

FATAL  -  Exhausted  tree  elements 

FATAL  -  Exhausted  connections 

Calls 

Function 

Where  Described 

rotate  location  index 

Section  2.5.18.5.14 

vec  mat  mul 

Section  2.6.2.56.1 

rotate  mat 

Section  2.5.18.5.9 

vec  nea 

Section  2.6.2.62.1 

vec  add 

Section  2.6.2.57.1 

vec  sub 

Section  2.6.2.65.1 

Table  2.5-394:  rotate_get_Ioc  Information. 

2.5.18.5.13  rotate_seMocation 

This  routine  is  called  when  the  location  of  a  child  with  respect  to  its  parent  is  set  directly.  It 
is  called  from  rotate_exec()  in  "rot_util.c". 


First,  copy  the  location  from  the  rotate  element  into  the  location  element.  If  this  is  a  parent- 
child  pair,  this  location  permanently  exists  and  no  existence  flags  need  to  be  set. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Calls  1 

■  Function  1 

Where  Described 

Section  2.6.2.59.1 

Table  2.5-395:  rotate_seMocation  Information. 

2.5.18.5.14  rotate_location_index 

This  routine  returns  the  index  into  locationjist  for  an  ordered  node  pair.  Parameters  are 
represented  as  follows: 

from  -  The  number  of  the  first  node  of  the  pair. 

to  —  The  number  of  the  second  node  of  the  pair. 

One  location  element  exists  for  each  ordered  node  pair.  This  means  that  the  location 
element  for  node  4  to  node  7  is  different  than  the  element  for  node  7  to  node  4,  although 
only  one  element  is  used  for  the  location  of  a  node  with  respect  to  itself.  The  memory  for 
the  elements  is  allocated  at  initialization.  This  routine  provides  a  way  to  access  a  location 
element  given  the  nodes  of  interest. 

Consider  the  same  array  described  in  the  comments  of  rotate_transform_index().  In 
this  case,  the  elements  below  the  diagonal  are  of  interest.  The  elements  on  the  diagonal 
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represent  the  location  of  a  node  with  respect  to  itself.  One  location  element  is  allocated  for 
all  these  locations  and  is  stored  at  the  end  of  the  list.  The  remaining  elements  are  stored 
row-wise.  This  could  be  thought  of  as  an  array  with  N-1  rows  and  N-2  columns.  The 
column  number  of  elements  in  the  upper  diagonal  of  this  effective  array  is  one  less  than  the 
actual  column  number.  The  lower  (hagonal  is  not  affected. 

The  last  element  in  the  list  is  returned,  and  represents  the  location  of  a  node  with  respect  to 
itself. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

from 

int 

Standard 

to 

int 

Standard 

1  Return  Values  I 

Return  Value 

Meanina 

node_count_minus_1  *  from 
+  to- 1 

int 

The  last  element  in  the  list 

node_count_minus_1  *  from 
+  to 

int 

The  last  element  in  the  list 

location  count 

int 

The  last  element  in  the  list 

Table  2.5-396: 


rotate  location  index  Information. 
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2.5.18.5.15  rotate_break_links 

When  the  location  and/or  orientation  of  an  element  with  respect  to  its  parent  is  changed,  a 
number  of  previously  calculated  transformations  and  locations  are  invalidated.  This  routine 
performs  the  invalidation. 


element 

translation 

orientation 

rotation 

currentbreak 

index 


--  A  pointer  to  the  rotate  element  that  has  been  operated  on. 

—  TRUE  if  the  location  of  element  with  respect  to  its  parent  has  changed, 
and  FALSE  otherwise. 

-  TRUE  if  the  orientation  of  element  with  respect  to  its  parent  has 
changed,  and  FALSE  otherwise. 

—  TRUE  if  the  change  in  orientation  is  due  to  a  rotation  about  an  axis 
rather  than  setting  a  new  orientation  directly. 

--  A  pointer  to  a  br^  element 

-  An  index  into  the  transformation  list. 


A  location  is  only  invalidated  if  a  change  in  orientation  of  location  has  occurred.  Note  that 
since  the  world  is  the  reference  node,  an  attempt  to  change  its  orientation  of  location  is  an 
error.  A  change  in  orientation  of  location  invalidates  all  locations  which  depend  on  this 
element,  except  for  the  locations  where  this  element  represents  the  last  node  pair  in  the 
path. 

Transformations  are  invalidated  only  if  a  change  in  orientation  occurs.  A  change  of 
orientation  invalidates  all  transformations  which  depend  on  this  element.  The  locations 
where  this  element  represents  the  last  node  pair  in  the  path  are  invalidated  only  if  a 
translation  has  occurred. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

translation 

int 

Standard 

orientation 

int 

Standard 

rotation 

int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

current_break 

pointer  to  struct 
break  element 

Section  2.5.18.5  rot_relate.c 

Index 

int 

Standard 

Errors 

Error 

Reason  for  Error 

LIBROTATElrotate  break  links):  WARNING 

Trying  to  break  links  due  to  world  nwvement 

Table  2.5-397:  rotate  break  links  Information. 
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2.5.18.5.16  dump_transform 

This  routine  is  used  for  debugging  purposes  only. 


1  Parameters  1 

Parameter 

Where  Tvnedef  Declared 

from 

int 

Standard 

to 

int 

Standard 

Table  2.5-398:  dump_transform  Information. 
2.5.18.5.17  dumpjocation 

This  routine  is  used  for  debugging  puiposes  only. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

from 

int 

Standard 

to 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

rotate,  location  index 

Section  2.5.18.5.14 

Table  2.5-399:  dumpjocation  Information. 


2.5.18.5.18 


dump_break_list 


This  routine  is  used  for  debugging  purposes  only. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

breakjist 

pointer  to  struct 
break  element 

Section  2.5.18.5  rot_relate.c 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

current_break 

pointer  to  struct 
break  element 

Section  2.5.18.5  rot_relate.c 

Table  2.5-400:  dump_break_list  Information. 
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2.5.18.5.19 


relate_dump_transforms 


This  routine  is  used  for  debugging  purposes  only. 


1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

from 

int 

Standard 

to 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

dumo  transform 

Section  2.5.18.5.16 

Table  2.5<401:  relate_dump_transforins  Information. 
2.5.18.5.20  relate_dump_locations 

This  routine  is  used  for  debugging  purposes  only. 


I  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

from 

int 

Standard 

to 

int 

Standard 

Calls 

Function 

Where  Described 

dump  location 

Section  2.5.18.5.17 

Table  2.5-402:  relate_dump_locations  Information. 
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2.5.18.6  rot  util.c 


Includes: 

"stdio.h" 

"math.h" 

"sini_types.h" 

"sim_dfns.h" 

"sim_macros.h 

"libmath.h" 

"libmatrix.h" 

"librotate.h" 

"UbrotJoc.h" 


ti 


Procedure  Declarations: 

ROTATE_ELEMENT_DEF(world_elen^nt) 

rotate_inU_check() 

rotate~exec() 

rotate~becoineJegal() 

rotatejstabO 

2.5.18.6.1  rotate_init 

This  routine  initializes  the  world  Allocated  memory  must  be  initialized  for  all  elements. 
The  routine  rotate  relate_init()  sets  up  all  memory  and  finds  out  the  relationships 
between  matrices.  The  routine  rotate_init_checkO  does  some  basic  idiot  checks,  then 
the  routine  rotate_exec()  is  called  to  ^ocess  the  commands. 


1  Calls  1 

Function 

Where  Described 

rotate  init  element 

Section  2.5.18.4.2 

rotate  relate  init 

Section  2.5.18.5.1 

rotate  init  check 

Section  2.5.18.6.2 

rotate  exec 

Section  2.5.18.6.4 

Table  2.5-403:  rotate_init  Information. 
2.5.18.6.2  rotate_mit_check 

This  routine  does  some  basic  idiot  checks. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

self 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

1  Internal  Variables  I 

Variable 

Tvoe 

Where  Typedef  Declared 

i 

int 

Standard 

state 

int 

Standard 

Return  Values 

1  Return  Value 

Meanina  1 
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state 

int 

If  state  =  TRUE, 

If  state  =  FALSE 

Errors 

Error 

Reason  for  Error 

rotateJnit_check: 

-  Stab  child  not  own  child 

-  Stab  child  not  STAB_CHILD  class 

-  Parent  not  STAB_PARENT  class 

-  Parents  stab  child  not  self 

Calls 

Function 

Where  Described 

rotate  init  check 

Section  2.5.18.6.2 

Table  2.5>404:  rotate  init  check  Information. 


2.5.18.6.3  rotate_simul 

This  routine  calls  rotate_relate_simul()  to  update  information  every  tick.  The  routine 
checks  to  see  that  you  ar^not  trying  to  rotate  the  world. 


I  Errors  I 

Error 

Reason  for  Error 

rotate  simul:  PANIC! 

Tryina  to  rotate  world 

Calls 

Function 

Where  Described 

rotate  relate  simul 

Section  2.5.18.5.4 

rotate  exec 

Section  2.5.18.6.4 

Table  2.5-405:  rotate  simul  Information. 
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2.5.18.6.4  rotate_exec 

This  routine  is  responsible  for  executing  the  various  KIN  Commands  which  are  listed  in 
"librot_loc.h".  The  parameter  represents  a  pointer  to  the  element  to  be  operated  on. 

The  routine  first  calls  the  pre_command_function(),  if  it  is  specified. 

If  the  element's  location  command  is  IKIN_COMMAND_LC)CATE,  try  to  locate  the 
element  and  then  fieeze  the  command  until  the  next  update.  This  is  done  by  the  hull  every 
tick. 

If  the  element's  orientation  command  is  IKIN_COMMAND_ORIENT,  orient  the  element 
with  the  translation  matrix  returned  from  rotate_set_tranform().  Once  oriented,  freeze 
the  command  until  the  next  update.  Note  that  this  command  is  executed  by  the  hull  every 
tick. 

If  the  element's  class  is  IKIN_CLASS_OFFSET  or  if  its  orientation  command  is 
IKIN_COMMAND_FREEZE,  the  rate  is  set  equal  to  zero,  signifying  no  motion. 

If  the  element  is  rotating  and  the  orientation  command  is  either 
IKIN_COMMAND_VECTOR_STAB,  IKIN_COMMAND_POINT_STAB,  or 
IKIN_COMMAND_RATE_STAB,  determine  the  angle  to  move  to  by  calling 

rotate_stab(). 

If  the  element  is  rotating  but  not  stabiUzing,  and  the  orientation  command  is 
IKIN_COMh^ND_ANGLE,  first  determine  whether  the  angle  is  inside  the  stops  by 
calling  rotate_becomeJegal().  If  the  angle  is  inside  the  stops,  then  calculate  the  fostest 
rate  and  correct  direction  to  turn  to  reach  it.  If  the  angle  is  outside  the  stops,  then  the 
closest  angle  within  the  range  is  found,  and  the  fastest  rate  and  correct  direction  are 
calculated 

If  the  element  is  rotating  but  not  stabilizing,  and  the  orientation  command  is 
IKIN_COMMAND_ANGLE_AND_RA'ITE,  determine  whether  the  angle  is  legal.  Turn  to 
the  specified  angle  at  the  desired  rate  if  the  angle  is  legal.  If  the  angle  is  not  legal, 
determine  a  legS  angle  and  the  rate  to  turn.  The  net  rate  is  the  rate  to  get  from  where  the 
element  should  be  to  where  it  wants  to  be. 

If  the  element  is  rotating  but  not  stabilizing,  and  the  orientation  command  is 
IKIN_CX)MMAND_RATE,  determine  whether  the  angle  is  inside  the  stops.  If  the  angle  is 
not  legal,  then  the  rate  is  the  larger  of  either  the  desired  rate  or  the  required  rate  to  get  to  a 
legal  position.  If  the  angle  is  legal,  the  rate  is  the  desired  rate.  Note  that  a  maximum  limit 
can  be  set  for  the  rate,  the  maximum  is  exceeded,  the  desired  rate  will  be  clipped  to  the 
maximum  rate.  The  angle  and  current  rate  are  updated  for  the  positive  and  negati\  e 
directions. 

After  executing  the  commands,  the  routine  calls  rotate_break_links()  which  records  the 
self,  translation,  orientation  and  rotation  flags.  Any  previous  calulatcd  matrices  that  ma\ 
now  be  incorrect  are  invalidated,  while  matrices  t’^at  are  still  correct  remain  valid. 

If  the  orientation  command  was  IKIN_COMMAND_RATE_STAB  and  the  class  is 
IKIN_CLASS_STAB_PARENT,  the  stab  vector  is  recorded. 

The  post_command_functlon()  is  then  called,  if  it  is  specified. 
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Lastly,  this  routine,  rotate_exec(),  is  recursively  called  for  each  child,  executing  the 
commands  for  each  elemenT  in  the  tree. 


Parameters 


Parameter 


self 


lEin 


pointer  to 

ROTATE  ELEMENT 


Where  Tvoedef  Declared 


Section  2.5.18.2  librotate.h 


Internal  Variables 

Variable 

Tvoe 

Where  Typedef  Declared 

orientation  command 

int 

Standard 

orientation_angle 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

desired.angle 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

desired.rate 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

net_rate 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

temp_ang 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

legaLang 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

req_rate 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

inside  stops 

int 

Standard 

translation 


orientation 


rotation 


Standard 


Standard 


Standard 


Standard 


Function 


rotate  set  location 


rotate  set  transform 


rotate  stab 


rotate  become  leqal 


rotate  valid  anole 


real  limit 


rotate  break  links 


vec  mat  mul 


rotate  exec 


Calls 


Where 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Described 


2.5.18.5.13 


2.5.18.5.10 


2.5.18.6.6 


2.5.18.6.5 


2.5.18.6.7 


2.6.1. 6.1 


2.5.18.5.15 


2.6.2.56.1 


2.5.18.6.4 


Table  2.5>406:  rotate  exec  Information. 
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2.5.18.6.5  rotate_become_legaI 

This  routine  determines  whether  the  angle  is  within  the  positive  and  negative  stops. 
Parameters  are  represented  as  follows: 

element  —  A  pointer  to  the  element  of  interest 
angle  -  The  an^e  to  be  checked. 
newjingle  -  A  pointer  to  a  legal  angle. 

rate  -  A  pointer  to  the  rate  in  radians  per  tick  to  move  from  angle  to  new  angle. 

If  the  angle  is  inside  the  stops,  the  angle  is  legal  and  the  routine  returns  TRUE.  If  the  angle 
is  outside  the  stops,  the  angle  is  not  legal  and  the  routine  returns  FALSE.  If  the  angle  is 
outside  the  stops,  a  pointer  is  set  to  new  angle,  which  is  the  closest  angle  within  the  stops. 
The  rate  to  turn  from  angle  to  new  angle  is  calculated. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

angle 

REAL 

/simnet/common/include/glob 
ai/sim  tvDes.h 

new_angle 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

rate 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

1  Return  Values  I 

Return  Value 

Meanina 

TRUE 

int 

The  angle  is  within  the  stops 

FALSE 

int 

The  angle  is  not  within  the 
stops 

Table  2.5-407:  rotate_become_legal  Information. 
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2.5.18.6.6  rotate_stab 

This  routine  calculates  the  stabilization  angle  of  die  parameter  self.  If  self  is  of  class  stab 
parent,  then  element  is  created  as  the  child  element. 

If  stabilizing  to  a  point,  the  stab  vector  is  calculated.  The  difference  between  your  location 
and  the  point  is  normalized  and  placed  into  your  coordinate  system.  If  stabilizing  to  a 
vector,  Ae  stab  vector  is  placed  in  your  coordinate  system.  If  your  class  is  stab  parent, 
then  the  child  has  a  base  vector  which  must  align  to  your  stab  vector. 

The  routine  returns  the  angle  you  need  to  move  to  for  stabilization. 


1  Parameters  1 

Parameter 

Typ 

e 

Where  Typedef  Declared 

self 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

Internal  Variables 

Variable 

Typ 

e 

Where  Typedef  Declared 

element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

stab_vector 

VECTOR 

/simnet/common/include/gfob 
al/sim  types. h 

temp_vector 

VECTOR 

/simnet/common/include/glob 
al/sim  types. h 

new_angle 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

sin_rot 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

cos_rot 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

stab_dot_axis 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

denominator 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

temp_1 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

temp_2 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

diff_angle 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

Return  Values 


Return  Value 


self->anale 


rotate_valid_angle 
(self->angle  +  new_angle) 


REAL 


REAL 


Meanin 


the  stabilization  angle 


the  stabilization  angle  which 
has  been  corrected  to  stay 
inside  the  stops 


Function 


vec  sub 


rotate  get  loc 


Calls 


Where  Described 


Section  2.6.2.65.1 


Section  2.5.18.5.12 
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vec  normalize 

Section  2.3.2.63.1 

vec  mat  mul 

Section  2.6.2.56.1 

rotate  aet  mat 

Section  2.5.18.5.5 

vec  dot  orod 

Section  2.6.2.54.1 

inv  sin  cos  rad 

Section  2. 6. 1.3. 2 

vec  cross  prod 

Section  2.6.2.66.1 

rotate  valid  anale 

Section  2.5.18.6.7 

Table  2.5-408:  rotate  stab  Information. 


2.5.18.6.7  rotate_valid_angle 

This  routine  determines  whether  angle  is  within  the  angle  range  of  -PI  to  PI  and  modifies 
the  angle  if  necessary. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

angle 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

1  Return  Values  I 

■  Return  Value 

Meaning 

REAL 

a  valid  angle  within  -PI  to  PI 

Table  2.5-409:  rotate_valld_angle  Information. 
2.5.18.6.8  world 

This  routine  returns  a  pointer  to  the  world  element. 


i  Return  Values  1 

Return  Value 

Meaning 

&world_element 

pointer  to 

ROTATE  ELEMENT 

Section  2.5.18.2  librotate.h 

Table  2.5-410:  world  Information. 
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2.5.19  libupdate 

(ysimnel/telease/src/vehicle/libsrc/libupdate  [libupdate]) 

This  library  contains  the  routines  necessary  to  move  the  vehicle  forward  in  time. 

2.5.19.1  libupdate.c 


Includes: 

"math.h" 

"sim_types.h" 

"sim_(frns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dyn_state.h" 

"kin_state.h" 

"dyn_mass.h" 


Defines: 

CIG_AGL 

STARTUP  CEILING 
CG_HEIGHT_OFFSET 

Declarations: 

ci  g_al  ti  tu  de_a  bove_gn  d  0 

vehTdyn  ~ 

veh_kin 

veh_freeze 

freeze_state() 

vehicle_place() 

init_stat^ 

agl 

veh_mass 

veh_init 
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_  Internal  Variables  _ 

Variable  E  Tvne  I  Where  Tvnedef  Declared 


Internal  Variables 


Calls 


Function 

Where  Described 

dynamics  calc  inertial  forces 

Section  2.5.7. 1.1 

B_w 

Macro  defined  in 

/simnet/release/src/libsrc/include/dyn  state. h 

B_v_cg 

Macro  defined  in 

/simnet/release/src/libsrc/include/dvn  state. h 

vec  add 

Section  2.6.2.57.1 

dynamics  calc  udot 

Section  2.5.7.3.1 

B_alpha 

Macro  defined  in 

/simnet/release/src/libsrc/include/dyn  state. h 

vec  mat  mul 

Section  2.6.2.56.1 

A_a_cg 

Macro  defined  in 

/simnet/release/src/libsrc/include/dyn_state.h 

dynamics  calc  u 

Section  2.5.7.2.1 

freeze  state 

Section  2.5.19.1.28 

cia  altitude  above  and 

Section  2. 1.2. 2. 3. 1.1 

vehicle  place 

Section  2.5.19.1.2 

v_mag 

Macro  defined  in 

/simnet/release/src/libsrc/include/dyn  state. h 

mag3 

Macro  defined  in 

/simnet/co  mmon/include/q  lobal/si  m  macros .  h 

kinematics  calc  oriain  state 

Section  2.6.18.1.2 

A_w 

Macro  defined  in 

/simnet/release/src/libsrc/include/dvn_state.h 

A_v_origin 

Macro  defined  in 

/simnet/release/src/libsrc/include/dyn  state. h 

A_v_cg 

Macro  defined  in 

/simnet/release/src/libsrc/include/dyn  state. h 

kinematics  form  e 

Section  2.6.18.5.1 

kinematics  update  p 

Section  2.6.18.12.1 

kinematics  update  e 

Section  2.6.18.11.1 

kinematics,  form  C 

Section  2.6.18.3.1 

kinematics,  form  G 

Section  2.6.18.6.1 

kinematics  form  N 

Section  2.6.18.4.1 

kinematics  form  s 

Section  2.6.18.8  1 

Table  2.5*41  h  vehicle  update  Information. 
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2.5.19.1.2  vehicle_place 

This  roudne  is  called  to  put  the  vehicle  in  a  new  place.  The  position  is  initialized,  then  the 
euler  parameters  are  set  The  direction  and  cosine  matrices  are  generated  from  kinematics. 

pos  -  position  vector  to  start 

fvel  —  forward  velocity 

direction  -  direction  pointing  to  start 

A  s  —  position  vector  from  B*  to  origin  expressed  in  frame  A 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pos 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

fvel 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

direction 

REAL 

/simnet/common/include/glob 
al/sim types.h 

1  Internal  Variables  1 

1  Variable 

Where  Tvpedef  Declared 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

1  Calls  1 

Function 

Where  Described 

B_v_cg 

Macro  defined  in 

/simnet/release/src/libsrc/include/dvn  state. h 

v_mag 

Macro  defined  in 

/simnet/release/src/libsrc/include/dvn  state.h 

B_w 

Macro  defined  in 

/simnet/release/src/libsrc/include/dyn  state.h 

kinematics,  form  C 

Section  2.6.18.3.1 

kinematics  form  G 

Section  2.6.18.6.1 

kinematics  form  N 

Section  2.6.18.4.1 

kinematics  form  s 

Section  2.6.18.8.1 

Table  2.5*4 12:  vehicle_place  Information. 
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2.5.19.1.3  vehicle_init 

This  routine  initializes  the  vehicle  position. 

pos  -  position  vector  to  start 

fvel  -  forward  velocity 

direction  -  direction  pointing  to  start 


j  Parameters  1 

Parameter 

Where  Typedef  Declared 

pos 

VECTOR 

/simnet/common/include/glob 
al/sim  types,  h 

fvel 

REAL 

/simnet/common/include/glob 
al/sim  types,  h 

direction 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

I  Calls  1 

Function 

Where  Described 

vehicle  place 

Section  2.5.19.1.2 

Table  2.5-413:  vehiclejnit  Information. 
2.5.19.1.4  vehicle_set_position 

This  routine  sets  the  vehicle  position  to  pos,  the  position  vector. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pos 

VECTOR 

/simnet/common/include/glob 
al/sim  types. h 

Calls 

Function 

Where  Described 

kinematics  form  s 

Section  2.6.18.8.1 

Table  2.5-414:  vehicle_set_position  Information, 
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2.5.19.1.4  vehicle_set_onentation 

This  routine  sets  the  vehicle  orientation  to  direction. 


1  Parameters  j 

Parameter 

Where  Typedef  Declared 

direction 

REAL 

/simnet/common/include/glob 
al/sim  types. h 

i  Calls  1 

Function 

Where  Described 

kinematics  form  C 

Section  2.6.18.3.1 

kinematics  form  G 

Section  2.6.18.6.1 

kinematics  form  N 

Section  2.6.18.4.1 

kinematics  form  s 

Section  2.6.18.8.1 

Table  2.5-415;  vehicle_set_orientation  Information. 
2.5.19.1.5  kinematics_set_orientation_matrix 
This  routine  forms  the  vehicle  orientation  matrix. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

b_c_a 

T_MATRIX 

/simnet/common/include/glob 
al/sim  types. h 

1  Calls  1 

Function 

Where  Described 

mat  copy 

Section  2.6.2.39.1 

mat  transpose 

Section  2.6.2.51.1 

make  e 

Section  2.6.18.9.1 

kinematics  form  G 

Section  2.6.18.6.1 

kinematics  form  N 

Section  2.6.18.4.1 

kinematics  form  s 

Section  2.6.18.8.1 

Table  2.5-416:  vehicle  set  orientation  matrix  Information. 
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2.5.19.1.16  vehicle_niass_init 

This  routine  initializes  die  vehicle  mass  parameters. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

mass 

REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

1 

T_MATRIX 

PHIHBliHI 

1  Calls  1 

Function 

Where  Described 

dynamics  ini% 

Section  2.5.7.5.1 

Table  2.5*417:  vehicle_niass_init  Information. 
2.5.19.1.77  vehicle_restart 

This  routine  restarts  the  vehicle  at  its  initial  position. 


1  Calls  1 

Function 

Where  Described 

vehicle  plac^ 

Section  2.5.19.1.2 

Table  2.5-418: 


vehicle  restart  Information. 


2.5.19.1.18  vehicle  A  acceleration 


This  routine  returns  the  acceleration  of  the  vehicle  in  frame  A. 


I  Return  Values  I 

Return  Vabue 

Meaning 

A_a_cg(veh  _dyn) 

pointer  to  REAL 

The  acceleration  of  the  vehicle 
in  frame  A. 

1  Calls  1 

Function 

Where  Described 

A_a_cg 

Macro  defined  in 

/simnet/release/src/libsrc/include/dyn  state. h 

Table  2.5*419:  vehicle  A  acceleration  Information. 
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2.5.19.1.9  vehicle_B_acceleration 

This  routine  returns  the  acceleration  of  the  vehicle  in  Frame  B. 


1  Return  Values  1 

Return  Value 

Meanina 

veh_dyn.a 

pointer  to  REAL 

the  acceleration  of  the  vehicle 
in  frame  B. 

Table  2.5-420:  vehicle_B_acceIeration  Information. 
2.5.19.1.10  vehicIe_A_velocity 

This  routine  returns  the  velocity  of  the  vehicle  in  Frame  A. 


1  Return  Values  I 

Return  Value 

Meaning 

A_v_cg(veh_dyn) 

pointer  to  REAL 

the  velocity  of  the  vehicle  in 
frame  A. 

1  Calls  1 

Function 

Where  Described 

A_v_cg 

Macro  defined  in 

/simnet/release/src/libsrc/include/dyn  state. h 

Table  2.5-421:  vehicle_^A_velocity  Information. 


2.5.19.1.11  vehicle_B_velocity 

This  routine  returns  the  velocity  of  the  vehicle  in  Frame  B. 


1  Return  Values  1 

Return  Value 

Meaning 

B_v_cg(ven_dyn) 

pointer  to  REAL 

the  velocity  of  the  vehicle  in 
frame  B. 

1  Calls  1 

Function 

Where  Described 

B_v_cg 

Macro  defined  in 

/simnet/release/src/libsrc/include/dyn  state. h 

Table  2.5-422:  vehicle_B_velocity  Information. 
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2.5..19.1.12 


vehicle_veIocity_magnitude 


Tti !  routine  returns  the  magnitude  of  the  velocity  vector. 


Retutrn  Value 


v_mfflg(veh_dyn) 


ID73 


Return  Values 


e 


REAL 


Meanin 


The  magnitude  of  the  velocity 
vector. 


Function 


v_mat3 


Calls 


Where  Described 


Macro  defined  in 

/simnet/release/src/libsrcyinclude/dvn  state. h 


Table  2.5-423:  vehicle_velocity_magnitude  Information. 


2.5.19.1.13 


vehicle  A  r 


This  routine  returns  the  vehicle's  change  in  position  vector  in  Frame  A. 


Return  Values 


Return  Value 


veh  kin.A  r 


pointer  to  REAL 


Meanin 


the  change  in  position  sector 
in  Frame  A. 


2.5..19.1.14 


Table  2.5-424:  vehlcle_A_r  Information. 
vehiclc_angular_velocity 


Thi&  routine  returns  the  vehicle's  angular  velocity. 


Re^i'rn  Value 


B  wc  veh  dvn 


Rt»»  rn  Values 


inter  to  REAL 


Meanin 


anoular  velocity  of  vehicle 


Function 


B  w- 


Calls 


Where  Described 


Macro  defined  in 

/simnet/release/src/libsrc/include/dyn  state. h 


Table  2.5-425:  vehicle_angular_velocity  Information. 


2.S.19.1.15 


vehicle_A_p 


This  routine  returns  the  vehicle's  position  vector,  from  the  origin  to  B*  in  Frame  A. 


Return  Values 


Return  Value 


veh  km  r-  p 


IEi13 


pointer  to  REAL 


Meanin 


vehicle  position  vector,  from 
origin  to  B*  in  Frame  A. 


Table  2.5-426:  vchicle  A  p  Information. 
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2.5.19.1.16  vehicle_B_s 

This  routine  returns  the  vehicle's  position  vector,  from  B*  to  the  origin  in  Frame  B. 


1  Return  Values  1 

Return  Value 

Meanina 

veh_kin.B_s 

pointer  to  REAL 

vehicle  position  vector,  from 

B*  to  origin  in  Frame  B. 

Table  2.5-427:  vehicle_B_s  Information. 
2.5.19.1.17  vehicle_b2 

This  routine  returns  the  normal  vector  of  the  vehicle  in  Frame  A. 


1  Return  Values  1 

Return  Value 

Meaning 

veh_kin.A_b2 

pointer  to  REAL 

normal  vector  of  vehicle  in 
Frame  A. 

Table  2.5-428:  vehicle_b2  Information. 
2.5.19.1.18  vehicle_A_C_B 

This  routine  returns  the  vehicle's  direction  cosine  matrix  from  A  to  B. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

veh_kin.A_C_B 

T_MAT_PTR 

vehicle  direction  cosine  matrix 
from  A  to  B. 

Table  2.5-429:  vehicle_A_C_B  Information. 
2.5.19.1.19  vehicle_B_C_A 

This  routine  returns  the  vehicle's  direction  cosine  matrix  from  B  to  A. 


1  Return  Values  1 

Return  Value 

Meaning 

veh_kin.B_C_A 

T_MAT_PTR 

vehicle  direction  cosine  matrix 
from  B  to  A. 

Table  2.5-430:  vehicle_B_C_A  Information. 
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22.5.19.1.20  vehicle_gravity_vector 
TThis  routine  returns  the  vehicle  gravity  vector  in  Frame  B. 


1  Return  values  1 

Return  Value 

Meanina 

v«h_kin.B_g 

pointer  to  REAL 

vehicle  gravity  vector  in  frame 

B. 

Table  2.S>431:  vehicle_gravity_vector  Information. 
21.5.19.1.21  vehicle_altitude 

This  routine  returns  the  altitude  of  the  vehicle. 


1  Return  Values  1 

Return  Value 

Meaning 

v^eh  kin.A  pf21 

REAL 

vehicle  altitude 

Table  2.5*432:  vehicle_altitude  Information. 
22.5.19.1.22  vehicle_climb_rate 

This  routine  returns  the  vehicle's  climb  rate:  the  velocity  of  the  origin  in  frame  A. 


1  Return  Values  1 

Return  Value 

Meanina 

/A  V  oriainfveh  dvn)f21 

REAL 

vehicle  climb  rate. 

1  Calls  1 

Function 

Where  Described 

A_v_origin 

Macro  defined  in 

/slmnet/release/src/libsrc/include/dyn  state. h 

Table  2.5-433:  vehicle_climb_rate  Information. 
v2.5.19.1.23  vehicle_freeze 

■^This  routine  sets  the  vehicle  ^freeze  flag  to  1.  This  routine  is  called  to  freeze  the  Stealth 
Vi'ehicle. 


2.5.19.1.24  vehicie_thaw 

This  routine  sets  the  vehicle  Jreeze  flag  to  0.  This  routine  is  called  to  unfreeze  the  Stealth 
n^ehicle. 


>2.5.19.1.25  vehicle_f  reeze_disable 

'.This  routine  sets  the  veh  Jreeze  enable  flag  to  0.  'This  routine  is  called  to  disable  the  freeze 
capabilities  of  the  vehicle. 
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2.5.19.1.26 


vehicle_torques 


This  routine  sets  the  vehicle's  torques  to  vai 


1  Parameters  1 

Parameter 

Where  Tvnedef  Declared 

val 

VECTOR 

/simnet/common/include/glob 
al/sim  types. h 

Table  2.5*434:  vehicle_torques  Information. 
2.5.19.1.27  vehicle_forces 

This  routine  sets  the  vehicle's  forces  to  val. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

val 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

Table  2.5-435:  vehicle_forces  Information. 
2.5.19.1.28  freeze^state 


This  routine  stops  the  vehicle's  motion,  setting  the  velocities  and  torques  to  zero. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

w 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

V 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

Table  2.5*436:  freeze  state  Information. 
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2.5.19.1.29  dump  routines 

The  following  routines: 
kin_dump() 
w_dump() 
vJTlumpO 
rjdumpO 
t_dump() 
vehicle_banner() 

are  used  to  prinfinformation  for  debugging  purposes. 

2.5.19.1.30  vehicle_set_init_state 

This  routine  is  used  by  the  stealth  vehicle  to  freeze  the  position  of  the  vehicle  when  an 

NLOS  missile  is  flying. 


Parameters 


Parameter 

Where  Tvoedef  Declared 

new  val 

int 

Standard 

Table  2.5-437; 


vehicle  set  init  state  Information. 
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Figure  2.6~l:  Simulation  Support  Software. 
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The  Utilities  are  a  collection  of  software  modules  used  to  perform  the  generic  functions  that 
are  not  specific  to  tfite  vehicle  simulation.  The  modules  that  are  included  in  this  category  are 
those  whose  fimctionality  is  general  enough  to  be  used  (invoked)  to  perform  operations  that 
are  not  specific  to  aany  one  subsystem  simulated.  A  primary  example  is  the  software  library 
of  math  routines  as^^able  to  perform  the  mathematical  operations  required  to  implement 
many  of  the  simulisted  subsystems.  These  utilities  are  represented  by  the  following  CSU's: 


libmath 

libnatrix. 

libtimezs 

libutil 

libshm 

libmove 

libser 

libfifo 

libevenc 

libmap 

libveh 

libmem 

ml_mBtia.c 

m2_meni:.c 

kato_memt.c 

librtc 

libfile 

libquat 
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2.6.1  llbmath 

(/simnei/telease/src/libsrc/libmath  pibmath]) 

Libmath  includes  routines  for  the  generation  of  random  variables,  computation  of  inverse 
trig  functions,  curve  fitting  and  polynomial  evaluation. 

2. 6. 1.1  bivar_dist.c 

(/simnetAolease/src/libsrc/libmath  /bivar_disLc) 

This  file  contains  a  routine  which  computes  a  zero-mean  normal  distribution  along  two 
axes. 

Includes: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 


Defines: 

K32 


2 .6 . 1 . 1 . 1  bivariant_normal_distribution 

This  routine  computes  a  zero-mean  normal  distribution  along  two  axes.  It  requires  a 
pointer  to  an  anay  of  floats  and  a  standard  deviation. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

aptrfl 

REAL 

Sim  types. h 

std  dev 

REAL 

Sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

random  numberl 

double 

Standard 

random  number2 

double 

Standard 

theta 

double 

Standard 

maanitude 

double 

Standard 

Table  2.6*1:  bivariant  normal  distribution  Information. 
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2.6. 1.2  cubic^funct.c 

(/simnetAelease/src/libsic/libmath/cubic_functc) 

This  file  contains  routines  which  generate  and  solve  a  function. 
Includes: 

"sim_dfns.h" 

"sim_types.h" 


2.6. 1.2.1  find_cubic_func 

This  routine  generates  a  cubic  function,  given  jc  O,  y_0,  the  X,Y  coordinates  of  the  break 
point  Oc  b,  y_b),  the  X,  Y  coordinates  of  an  end  point  yj),  a  factor  related  to  the 
curvature  of  the  function  (f),  and  a  pointer  to  an  array  which  contains  nine  values 
(fmc_arg[J). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

X  0 

REAL 

Sim  types. h 

y  0 

REAL 

Sim  tvpes.h 

X  b 

REAL 

Sim  tvpes.h 

V  b 

REAL 

Sim  tvpes.h 

X  1 

REAL 

Sim  tvpes.h 

V  I 

REAL 

Sim  tvpes.h 

f 

REAL 

Sim  tvpes.h 

func  arosf] 

REAL 

1  lliili'l  1 1  Hi—— 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

a  max 

REAL 

Sim  tvpes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

FALSE 

int 

The  function  could  not  be 
generated 

TRUE 

int 

The  function  was  generated. 

Table  2.6'2:  find  cubic  func  Information. 
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2. 6. 1.2. 2  cubic_func 

This  routine  finds  a  solution  to  the  cubic  function,  given  an  x  value  and  an  array  containing 
nine  values  used  to  generate  the  curve. 


1  Parameters  i 

Parameter 

Where  Tvpedef  Declared 

val 

REAL 

Sim  types. h 

func  arasn 

REAL 

Sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

temp 

REAL 

simjypes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

(val  •  (val  *  (val  *  func_args[5]  + 
func_args[6] )  +  1unc_args[7]) 

+  func  araslSI) 

REAL 

the  solution  of  the  function  at 
val  (val  >  func_args[0]) 

(val  *  func_args(31  + 
func  arQsr41) 

REAL 

the  solution  of  the  function  at 
val  (val  >=  func  argsfH) 

(func_args[2]  -  (temp*  (temp  * 
(temp  *  func_argst5]  + 
func_args[6])  +func_args[7])  + 
func  argslSI) 

REAL 

the  solution  of  the  function  at 
val 

Table  2.6-3:  cubic_func  Information. 


2.6. 1.3  inv_sin_cos.c 

(/simnetAelease/src/libsrc/libmath/inv_sin_cos.c) 

This  file  contains  routines  which  return  an  angle  in  degrees  or  radians  when  given  the  sin 
and  cosine  of  the  angle. 

Includes; 

"sim_types.h" 

"sim_dfns.h" 


Defines: 


HALF.PI 

S_C_45 

DEG_OOEFF_3 

DEG_OOEFF_l 

RAD_COEFF_3 

RAD_COEFF_l 
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2.6. 1.3.1  inv_sin_cos_deg 

Given  the  sine  and  cosine  of  an  angle,  this  routine  returns  the  value  of  the  angle  in  degrees. 


Parameters 


Parameter 


s 


c 


REAL 


REAL 


Where  Tvpedef  Declared 


Sim  tvDes.h 


sim  tvpes.h 


Return  Value 


(DEG_COEFF_3*s*S  + 
DEG  COEFF  1)*s 


(DEG_COEFF_3*c*C+ 
DEG  COEFF  1)*c-90 


(-DEG_COEFF_3*c*c- 
DEG  COEFF  11*0+90 


(-DEG_COEFF_3*s*s- 
DEG  COEFF  11*8+180 


(-DEG_COEFF_3*s*s- 
DEG  COEFF  11*s-180 


IE27!I 


e 


REAL 


REAL 


REAL 


Return  Values 


Meanin 


angles  between  -45'’  and  45'’ 


angles  between  -135°  and 
-45° 


angles  between  45°  and  135° 


angles  between  135°  and 
180° 


angles  between  -180°  and 
-135° 


Table  2.6-4:  inv_sin_cos_deg  Information. 


2.6. 1.3.2  inv_sin_cos_rad 

Given  the  sine  and  cosine  of  an  angle,  this  routine  returns  the  value  of  the  angle  in  radians. 


Parameter 


s 


\fm 


e 


REAL 


REAL 


Parameters 


Where  Typedef  Declared 


sim  tvDes.h 


sim  tvoes.h 


Return  Values 


Return  Value 


(RAD_COEFF_3*S*S  + 
RAD  COEFF  11*s 


(RAD_COEFF_3*C*C+ 

RAD  COEFF  11*C-HALF  PI 


(-RAD_COEFF_3*C*C- 
RAD  COEFF  11*c+HALF  PI 


(-RAD_COEFF_3*s*s- 
RAD  COEFF  11*s+PI 


(-RAD_COEFF_3*s*s- 
RAD  COEFF  11*s-PI 


e 


REAL 


REAL 


REAL 


Meanin 


angles  between  -PI/4  and  PI/4 


angles  between  -  3*PI/4  and  - 
PI/4 


angles  between  PI/4  and 
3*  PI/4 


angles  between  3*  PI/4  and  PI 


angles  between  -PI  and  - 
3*  PI/4 


Table  2.6-5:  inv_sin__cos_deg  Information. 
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2.6. 1.4  least_sq_fit.c 

(/simnet/reiease/src/libsrc/libmath/least_sq_fit) 

This  file  is  an  implementation  of  the  least  squares  method  for  fitting  a  general  polynomial: 

y  =  +  a,*  X  +  a^*  x*  +...+  a/  x' 

to  a  set  of  data  points  <xo,yo>i  <xi.yi>.  —  .  <Xn.yn>- 

Any  subset  of  the  coefficients  ai  is  allowed  to  be  fixed,  and  therefore  there  are  at  most  r+1 
parameters  to  solve  for.  Reference  any  engineering  mathematics  text  for  further 
information  about  this  algorithm. 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"least_sq_fit.h" 

Declarations: 

The  following  are  various  matrices  and  arrays  for  intermediate  values: 

**x_powers 

*x_powers_data 

*x_powers_sums 

**y_powers 

*y_powers_data 

*y_powers_sums 

♦*sim_lin_eq 

♦sim_lin_eq_data 

*sim_lin_eq_sums 

*sim_lin_eq_sol 

This  is  the  rank,  or  dimension,  of  the  matrix  describing  the  simultaneous  equations  which 
must  be  solved: 
rank 

The  following  procedures  are  declared: 
aIlocate_x_powers() 
allocate”y~powersO 
aIlocate”sfmJin_eq() 
generate_x_powers() 
generate”y~powers() 
generate”sim_lin_eq() 
solve_sim_liiir_eq'() 
geneMte_output_coeff_vaIs() 
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2.6. 1.4.1  least_squares_fit 

This  is  the  general  algorithm.  Given  the  general  polynomial: 


y  =  Bq  +  a,*  X  +  82*  X®  +...+  a,*  x'  =  X 


aj*  X 

1=0 

and  the  data  points  <xo,yo>,  <xi,yi>, ... ,  <xn,yn>,  each  deviation,  or  residual,  is  of  the 
form: 

r 


=  Sa,*x'- 


1-0 


I 


with  i=0,l,2...,n.  The  sum  of  the  squares  of  the  deviations  is: 

s=iv^ 

l«0 


Since  S  is  a  function  of  the  ak  which  are  not  fixed,  S  may  be  minimized  by  setting  the 
partial  derivatives  of  S  with  respect  to  each  ak  equal  to  0.  The  following  results: 

dS  dv. 

da. 


=  2*Sv 


=  0 


•  n  ‘  da„ 

k  isO  k 

with  k=0,l,...,r.  Since  the  partial  derivatives  are 

k 

and  dividing  through  by  2: 


Sv,* 


l>0 


,  x:=o 


Substituting  for  vi,  the  following  is  found; 

Sa,*  S<'i^''  =  Xx;y, 

j=0  i=0  1=0 

with  k=0,l,...,r.  This  can  be  written  as: 

Sa,*  = 

1=0  1=0  i=0 

with  k=0,l,...,r.  This  represents  an  equation  for  each  value  of  k  which  corresponds  to  a 
polynomial  ak  which  is  not  fixed.  The  result  is  simultaneous  linear  equations  with  the 
number  of  equations  equal  to  the  number  of  unknowns,  which  is  equ^  to  the  number  of 
non-fixed  polynomial  coefficients.  The  procedure  Ieast_squares_fit()  must  generate  all 
the  sums 

n 


1-0 


with  p=0,l,...,2*r,  and  it  must  generate  the  sums 


Sx';*  y, 


1=0 


with  p=0,l,...,2*r.  The  routine  then  sets  up  the  simultaneous  linear  equations  in  the 
variables  ak,  and  solves  these  equations  to  determine  the  coefficients  of  the  polynomial. 
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The  arguments  to  least_squares  fit()  are  as  follows:  num  data _po//iw  is  equal  to  n+1. 
x_yals  is  an  array  of  length  numdata _points  which  stores  x  values.  y_vals  is  an  array  of 
length  lum  data  joints  which  stores  y  values,  poly  degree  is  equal  to  r. 
input_coeff_yals  is  is  an  array  of  length  poly  degree  +  1  which  stores  coefficients  of  the 
polynomid.  These  coefficients  are  either  UNKNOWN_COEFF  or  are  fixed  REAL 
numbers,  output  coeff  vals  is  an  array  of  length  poly  degree  +  1  which  will  hold  the 
solution  coefficients  ^termined  by  this  routine. 


I  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

num  data  ooints 

int 

Standard 

poly  degree 

int 

Standard 

X  vals 

pointer  to  REAL 

sim  types. h 

V  vals 

pointer  to  REAL 

sim  types. h 

input  coeff  vals 

pointer  to  REAL 

sim  types. h 

output  coeff  vals 

pointer  to  REAL 

sim.tvpes.h 

1  Calls  1 

Function 

Where  Described 

allocate  x  powers 

Section  2.6. 1.4.2 

Section  2.6.1 .4.3 

allocate  sim  lin  eq 

Section  2.6.1  4.4 

generate  x  powers 

Section  2.6. 1.4.5 

generate  v  powers 

Section  2.6.  i  .4.6 

generate  sim  lin  eg 

Section  2.6.1. 4.7 

generate  output  coeff.  vals 

Section  2.6.1. 4.9 

Table  2.6-6:  least_squares_fif  Information. 


2. 6. 1.4. 2  allocate_x_powers 

This  routine  allocates  memory  for  all  of  the  sums: 


1x0 

with  p=0, 1, ....  2*r.  num  data  joints  is  the  number  of  data  points,  and  degree  joly  is 
the  degree  of  the  polynomial. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

num  data  points 

int 

Standard 

poly  degree 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.6-7:  allocate_x_powers  Information. 
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2. 6. 1.4. 3  aIlocate_y_powers 

This  routine  allocates  memory  for  all  of  the  sums: 

Xx'I*  y, 

1=0 

with  p=0, 1, 2*r.  num  data  jjoints  is  the  number  of  data  points,  and  degree _poly  is 
the  degree  of  the  polynomial. 


Parameters 


Parameter 


num  data  points 


ly  decree 


IS 


Where  Typedef  Declared 


Standard 


Standard 


Internal  Variable 


IfTH 


Internal  Variables 


Where  Tvpedet  Declared 


Standard 


Table  2.6-8:  aliocate_y_powers  Information. 


2.6. 1.4.4  allocate_sim_lin_eq 

This  procedure  allocates  memory  for  simultaneous  linear  equations  where  the  unknowns 
represent  the  unknown  coefficients  in  the  general  polynomial.  The  rank  of  the  matrix 
representing  the  simultaneous  linear  equations  is  equd  to  the  number  of  unknown 
coefficients  in  the  polynomial,  input _coeff_yals  represents  the  value  of  the  input 
coefficients,  and  degree _pofy  is  the  degree  of  the  polynomial. 


Parameter 


input  coeff  vals 


oly  decree 


IDT! 
IIS 


Parameters 


inter  to  REAL 


Where  Tvpedef  Declared 


Sim  types. h 


Standard 


Internal  Variable 


Dn 


Internal  Variables 


Where  Typedef  Declared 


Standard 


Standard 


Table  2.6-9:  aIlocate_sim_lin_eq  Information. 
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2. 6. 1.4. 5  generate_x_powers 
This  procedure  generates  all  the  sums: 

ix' 

1-0 

with  p=0,l,...,2*r  and  where  xiP  is  stored  in  position  x _powers[i][pJ,  and  the  above  sum 
is  stored  in  x  j)owers_sums[p].  num  data _points.  represents  the  number  of  data  points; 
degree _poly,  the  degree  of  the  polynomial.  The  input  x  values  are  represented  hyx_yals. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

int 

Standard 

poly  degree 

int 

Standard 

X  vals 

pointer  to  REAL 

Sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

X  val 

REAL 

Sim  types. h 

REAL 

Sim  types. h 

X  powers  sum 

REAL 

Sim  types. h 

i 

int 

Standard 

J _ 

int 

Standard 

Table  2.6-10:  generate_x_powers  Information. 


2.6. 1.4.6  generate_y_powers 

This  procedure  generates  all  the  sums: 


n 


1=0 

with  p=0,l,..„2*r  and  where  xiP*yi  is  stored  in  position  y _powers[iJ[p],  and  the  above 
sum  is  stored  in  y _powers_sums[p].  The  number  of  data  points  is  represented  by 
num  data _poirus.  The  degree  of  the  polynomial  is  represented  by  degree _poly.  The  input 
y  values  are  represented  by  y  vals. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

num  data  points 

int 

Standard 

poly  degree 

int 

Standard 

y  vals 

pointer  to  REAL 

Sim  types.h 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

y  powers  sum 

REAL 

Sim  types.h 

i 

int 

Standard 

J _ 

int 

Standard 

Table  2.6-11:  generate_y_powers  Information. 
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2.6. 1.4.7  generate_simjin_eq 

This  procedure  generates  simultaneous  linear  equations.  The  equation: 

Xa,*  X('*'‘  =  Xx;y, 

i>0  1-0  1-0 

with  k=0,l,....r,  represents  an  equation  for  each  value  of  k  which  corresponds  to  a 
polynomial  coefficient  ak  which  is  not  fixed.  For  each  equation,  the  unlmown  aj's  end  up 
on  the  left  hand  side  with  coefficients  taken  from  x  j>owers_sums,  and  the  fixed  aj's 
multiplied  by  their  coefficients  are  subtracted  from  the  y _powers_sums  on  the  right  hand 
side. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

int 

Standard 

oolv  decree 

int 

Standard 

vals 

pointer  to  REAL 

Sim  tvpes.h 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

k 

int 

Standard 

eq  num 

int 

Standard 

coeff  num 

int 

Standard 

Table  2.6-12:  generate_simjin_eq  Information. 


2.6. 1.4.8  solve_sim_lin_eq 

This  procedure  solves  the  simultaneous  linear  equations  using  the  eleimination  method, 
writing  the  solutions  into  the  array  sim  jin  eq  sol. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

i 

int 

Standard 

k 

int 

Standard 

dividend 

REAL 

Sim  tvpes.h 

factor 

REAL 

Sim  tvpes.h 

Table  2.6-13:  solve_sim_lin_eq  Information. 
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2. 6. 1.4.9 


generate_output_coeff_  vals 


This  procedure  places  the  solutions  of  the  simultaneous  linear  equations  into  their  proper 
positions  in  the  general  polynomial,  skipping  the  polynomial  coefficients  that  were  initially 
fixed.  The  degree  of  the  polynomial  is  represent^  by  degree _poly.  The  input  and  output 
coefficients  are  represent  by  irtput_co^_yals  and  output j:oeff  vals,  respectively. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

poly  dearee 

int 

Standard 

input  coeff  vals 

pointer  to  REAL 

Sim  types. h 

output  coeff  vals 

pointer  to  REAL 

Sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

index 

int 

Standard 

Table  2.6*14:  generate_output_coeff_vals  Information. 


2.6.1.5  libmath.h 

(/simnetAelease/src/libsrc/libmath  /libmath.h) 

This  file  declares  the  following  functions  as  external  so  that  they  can  be  used  outside  of 
libmath. 

least  squares_fit() 

bivanant_norniaI_distribution() 

scaled_rand() 

find_cubic_func() 

cubic  funcT) 

i  n  v_s  m_cos_ra  d  ( ) 

inv^sin  cos~deg() 

reap  liniit()  ~ 

int  iimitO 
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2.6.1.6  limit.c 

(/simnet/release/src/libsic/libmath  /litnitc) 


This  file  contains  routines  which  limits  the  value  that  a  parameter  can  have. 


2.6. 1.6.1  reaMimit 

This  routine  limits  the  value  of  the  input  parameter,  limit  is  the  limit  that  you  wish  to 
impose,  and  input  is  a  pointer  to  the  input  parameter  to  be  cropped. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

inout 

pointer  to  REAL 

Sim  tvpes.h 

limK 

REAL 

Sim  types. h 

Table  2.6-15:  real  limit  Information. 


2. 6. 1.6. 2  intjimit 

This  routine  limits  the  value  of  the  input  parameter,  limit  is  the  limit  that  you  wish  to 
impose,  and  input  is  a  pointer  to  the  input  paran^ter  to  be  cropped. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

input 

pointer  to  int 

Standard 

limit 

int 

Standard 

Table  2.6-16:  int  limit  Information. 
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2.6.1.7  scaled  rand.c 

(/simnet/release/sic/libsic/libinath  /scaled jrandh) 

This  file  contains  a  function  which  generates  a  REAL  random  number  between  0.0  and 

1.0. 

Includes: 

"stdio.h" 

"ctype.h” 

"math.h" 

"sim_dfns.h" 

'sim_types.h" 

"sim  macros.h" 


Defines: 

K32 

2.6. 1.7.1  scaled_rand 

This  routine  generates  a  random  REAL  number  between  0.0  and  1.0. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared  I 

random  number 

REAL 

sim  tvpes.h  1 

Return  Values 

Return  Value 

Type 

Meaning 

random_number 

REAL 

a  random  number  between 

0.0  and  1 .0 

Table  2.6*17:  scaled  rand  Information. 
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2. 6. 2. 2  d2f_v_copy.c 

This  Ble  contains  a  routine,  d2f_v_copy,  which  copies  a  source  vector  to  a  destination 
vector. 

The  following  files  are  included: 

"stdio.h" 

"ctype-h" 

"inath.h'’ 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libinatrix.h" 


2. 6. 2. 2.1  d2f_vec_copy 

This  routine  copies  a  source  vector  to  a  destination  vector. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

srcl31 

double 

Standard 

dst  131 

float 

Standard 

Table  2.6-19:  d2f_v_copy  Information. 


2.6.2.3  eIr_copy.c 

This  file  contains  a  routine,  elr_copy,  which  copies  E_PARAM  from  to  E_PARAM  to. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libniatrix.h" 


2. 6. 2. 3.1  elr_copy 

This  routine  copiers  E_PAEAM  from  to  E_PARAM  to. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

from 

E  PARAM 

Sim  types.h 

to 

E  PARAM 

Sim  types.h 

Table  2.6-20:  elr_copy  Information. 
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2. 6. 2. 4  elr  elr  cat.c 


This  nie  contains  one  procedure,  elr_elr_cat,  which  concatonates  two  Euler  parameters. 


The  following  files  are  included: 
"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"Ubmatrix.h" 


2. 6. 2. 4.1  elr_elr_cat 

This  routine  concatonates  two  Euler  parameters. 

A_e_B0  are  the  Euler  parameters  for  rotation  from  A  to  BO.  B0_e_B  are  the  Euler 
parameters  for  rotation  fi-om  BO  to  B.  A  e_B  are  the  Euler  parameters  for  rotation  from  A 
to  B. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

A  e  BO 

E  PARAM 

Sim  tvpes.h 

BO  e  B 

E  PARAM 

Sim  types.h 

A  e  B 

E  PARAM 

Sim  tvpes.h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

maq 

real 

Standard 

Table  2.6-21:  elr_elr_cat  Information. 
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2.6. 2.5 


elr  form.c 


This  file  contains  one  procedure,  elr_fonn,  which  creates  E_PARAM  given  the  axis  of 
rotation  and  an  angle. 


This  file  includes: 
"stdio.h" 
"ctype.h" 
"math.h" 
"sim_dfiis.h" 
"sim_types.h" 
"sim_macios.h" 
"libmatrix.h" 


2. 6. 2. 5.1  elr_form 

This  routine  creates  an  E.PARAM  given  the  axis  of  rotation  and  an  angle. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

laxis 

VECTOR 

Sim  types.h 

REAL 

Sim  tvpes.h 

1  result 

E  PARAM 

Sim  tvpes.h 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

sin  half  ana 

REAL 

Sim  types.h 

Table  2.6-22:  elr  form  Information. 


» 
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% 


2. 6. 2. 6  elr  idtet.c 


This  file  contains  onerpraceduie,  dMdent,  which  initializes  an  E.PARAM  to  an  identity 
transfonnation. 


This  file  includes: 
"stdio.h" 
"ctype.h" 
"math.h" 
"sim_dfns.h" 
"sim_types.h" 
"sim_maCK».h:"' 
”libmatrix.h.'' 


2. 6. 2. 6.1  elr^kfeitt 

This  routine  initializes  an  H_PARAM  to  an  identity  transformation. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

e 

E  PARAM 

Sim  types. h 

Tid>le  2.6-23:  elr  ident  Information. 
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2.6. 2.7  elr_to_mat.c 

This  file  contains  one  procedure,  elr  tojnat,  which  converts  from  an  E_PARAM  to  a 

T_MATRIX. 

This  file  includes: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sini_types.h" 

"sim_macros.h" 

'*Ubmatrix.h" 


2. 6. 2. 7.1  elr_to_mat 

This  routine  converts  from  an  E_PARAM  to  a  T_MATRIX.  A_e_B  is  the  quaternion  for 
rotation  of  B  to  A.  A_c_B  is  the  direction  cosine  matrix  from  frame  A  to  frame  B.  temp  is 
a  temporary  variable. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

A  e  B 

E  PARAM 

Sim  tvpes.h 

A  c  B 

T  MATRIX 

Sim  types. h 

(nternat  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

temp 

REAL 

Sim  types.h 

eOeO 

REAL 

Sim  types.h 

e0e1 

REAL 

Sim  types.h 

e0e2 

REAL 

Sim  types.h 

eOeS 

REAL 

Sim  types.h 

elel 

REAL 

Sim  types.h 

ele2 

REAL 

Sim  types.h 

e1e3 

REAL 

Sim  types.h 

e2e2 

REAL 

Sim  types.h 

e2e3 

REAL 

Sim  types.h 

e3e3 

REAL 

Sim  types.h 

Table  2.6>24:  elr_to_mat  Information. 
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2. 6. 2. 8  elr_transp.c 


This  file  contains  one  procedure,  dr_transp<»e,  which  transposes  an  E_PARAM  into 
die  E_PARAM.  ” 


This  file  includes; 
"stdio.h" 
"ctype.h" 
"inath.h" 
"sim_dfns.h" 
"sim_types.h" 
"sim_inacros.h" 
"libmatrix.h" 


2. 6. 2. 8.1  elr_transpose 

This  routine  transposes  an  E_PARAM  into  the  result  E_PARAM. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

e 

E  PARAM 

Sim  types. h 

result 

E  PARAM 

Sim  types. h 

% 


Table  2.6>25:  eIr_transpose  Information. 


2.6.2.9  f2d_m_copy 


This  file  contains  one  procedure,  f2d_mat_copy,  which  copies  a  source  matrix  to  a 
destinadtm  matrix.  ”  ~ 


This  file  includes: 
"stdio.h" 
"ctype.h" 
"math.h" 
"sim_dfns.h" 
"sim_types.h" 
"sim_macros.h" 
"libmatrix.h" 


2. 6. 2. 9.1  f2d_mat_copy 

This  routine  copies  a  source  matrix  to  a  destination  mauix. 


1  Parameters  1 

[Parameter 

Type 

Where  Typedef  Declared 

Isrcl31131. _ 

float 

Standard 

double 

Standard 

Table  2.6-26:  f2d_mat_copy  Information. 
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2.6.2.10  f2d_v_copy.c 

This  file  contains  one  procedure,  f2d_vec_copy,  which  copies  a  source  vector  to  a 

destination  vector. 

This  file  includes: 

"stdio.h" 

"ctype.h" 

"math.h" 

"siin_(lfhs.h" 

"sim_types.h" 

"sim_macros.h" 

"libtnatrix.h 

2.6.2.10.1  f2d_vec_copy 

This  routine  copies  a  source  vector  to  a  destination  vector. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

srclSI 

float 

Standard 

double 

Standard 

Table  2.6-27: 


f2d_vec_copy  Information. 
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2.6.2.11  fm^check.c 

This  file  contains  one  procedure,  ftnatjcheck,  which  checks  that  all  vectors  in  a  matrix  of 
floats  ate  normalized. 

This  file  includes: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"Ubmatrix.h" 


2.6.2.11.1  fmat_check 

This  routine  checks  to  ensure  that  all  vectors  in  a  matrix  of  floats  are  normalized. 


Parameters 


Parameter 


Where  Tvpedef  Declared 


Standard 


Internal  Variables 


Internal  Variable 


ICTtlSlifll 


Where  Tvpedef  Declared 


Standard 


Return  Values 


Return  Value 


TRUE 


FALSE 


Meanin 


all  vectors  normalized 


not  all  vectors  normalized 


Function 


fmat  CO 


fvec  check 


fmat  transpose 


Calls 


Where  Described 


Section  2.6.2.12  fm  copy.c 


Section  2.6.2.20  fv  check.c 


Section  2.6.2.19  fmat  transp.c 


Table  2.6>28:  fmat  check  Information. 
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2.6.2.12  fm_copy.c 

This  file  contains  one  procedure.  fknat_copy,  which  copies  a  float  matrix  from  to  a  float 
matrix  to. 

This  file  includes: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.12.1  finat_copy 

This  procedure  copies  a  float  matrix  from  to  a  float  matrix  to. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

from  131 131 

float 

Standard 

to  [31  [31 

float 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

to  temp 

reaister  float 

Standard 

from  temp 

register  float 

Standard 

Calls 

Function 

Where  Described 

fmat  check 

Section  2.6.2.11  .1 

fmat  transpose 

Section  2.6.2.19  .1 

Table  2.6>29:  fmat_copy  Information. 
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2.6.2.13  fm  id  init.c 


This  file  contains  one  procedure,  ftaiatjdent Jnit,  which  initializes  a  matrix  to  be  the 
identiQr  matrix.  ~  ” 


This  file  includes; 
"stdio.h" 
"ctype.h" 
"math.h” 
"sim_dfhs.h" 
"sim_types.h" 
"sim_macros.h" 
"Ubmatnx.h" 


2.6.2.13.1  fmatjdentjnit 

This  procedure  initializes  a  matrix  to  be  the  identity  matrix. 


1  Parameters  1 

1  Parameter  1 

Type 

Where  Tvpedef  Declared 

float 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

m  ptr 

reoister  float 

Standard 

Table  2.6-30:  fmatjdentjnit  Information. 
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2.6.2.14  fin_in_mul.c 

This  file  contains  one  procedure,  which  multiplies  two  float  matrices 

together  and  stores  the  result.  ~ 

This  file  includes: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.14.1  fmat_mat_mul 

This  procedure  multiplies  two  float  matrices  together  and  stores  the  result. 


Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

m1[3lf31 

float 

Standard 

float 

Standard 

float 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

ml  00 

static  float 

Standard 

m1  01 

static  float 

Standard 

m1  02 

static  float 

Standard 

ml  10 

static  fioat 

Standard 

ml  11 

static  float 

Standard 

ml  12 

static  fioat 

Standard 

ml  20 

static  float 

Standard 

ml  21 

static  float 

Standard 

ml  22 

static  float 

Standard 

m2  00 

static  fioat 

Standard 

m2  01 

static  float 

Standard 

m2  02 

static  float 

Standard 

m2  10 

static  float 

Standard 

m2  11 

static  float 

Standard 

m2  12 

static  float 

Standard 

m2  20 

static  float 

Standard 

m2  21 

static  fioat 

Standard 

m2  22 

static  fioat 

Standard 

mat  Dtr 

reaister  float 

Standard 

res  Dtr 

reaister  float 

Standard 

Table  2.6-31:  fmat  mat  mul  Information. 
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2.6.2.15  fin_r__lnlt.c 

This  file  contains  one  procedure,  fhiat_rot_init,  which  initializes  a  matrix  to  be  a  rotation 
matrix.  ” 

This  file  includes: 

"stdio.h" 

”ctype.h" 

"math.h" 

"sim_dfhs.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 

2.6.2.15.1  fmat_rot_init 

This  procedure  initializes  a  matrix  to  be  a  rotation  matrix.  Rotation  is  counter-cloclcwise 
when  viewed  along  a  positive  axis. 


1  Parameters  1 

■  Parameter 

Tvoe 

Where  Tvoedef  Declared 

float 

Standard 

theta 

float 

Standard 

rot  axis 

int 

Standard 

Table  2.6*32:  fmat_roMnit  Information. 


2.6.2.16  fmat_dump.c 

This  file  contains  one  procedure,  fniat_dump,  which  dumps  a  matrix  to  the  standard 

output.  ” 

The  following  files  are  included: 

"st<£o.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 

2.6.2.16.1  fmat_dump 

This  procedure  prints  a  matrix  and  a  descriptive  message  to  the  standard  output. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

Istr 

char 

Standard 

float 

Standard 

Table  2.6-33:  fmat_dump  Information. 
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2.6.2.17  finat_r_init2.c 

This  file  contains  one  procedure,  ftiiat_rot Jnit2,  which  initializes  a  matrix  to  be  a 
rotation  matrix.  ~ 

This  file  includes: 

"stdio.h" 

'*ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.17.1  fmat_rot_init2 

This  procedure  initializes  a  matrix  to  be  a  rotation  matrix,  given  the  sine  of  an  angle  instead 
of  the  angle  itself.  Rotation  is  counter-clockwise  when  viewed  along  a  positive  axis. 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

m  131131 

float 

Standard 

sin  theta 

REAL 

Sim  tvoes.h 

rot  axis 

int 

Standard 

1  Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

cos  theta 

float 

Standard 

one  minus  sqr  sin 

float 

Standard 

m  Dtr 

register  float 

Standard 

Calls 

Function 

Where  Described 

sauare 

Sim  macros.h  (macro  definition) 

abs 

Sim  macros.h  (macro  definition) 

Table  2.6*34:  fmat_rot_init2  Information. 
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2.6.2.18  fmat_sub.c 

This  nie  contains  one  procedure,  fknat_sub,  which  subtracts  two  matrices. 

This  file  includes: 

•■stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"Ubmatiix.h" 


2.6.2.18.1  fmat_sub 

This  procedure  subtracts  matrix  m2  from  ml. 


1  Parameters  I 

1  Parameter  1 

Where  Tvoedef  Declared 

1  III  III  I—— 

float 

Standard 

luhllDltD  ■■■■■■■■ 

float 

Standard 

1  result  131 131 

float 

Standard 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

ml  P 

reoister  float 

Standard 

m2  P 

reqister  float 

Standard 

result  P 

register  float 

Standard 

Table  2.6*35:  fmat_sub  Information. 
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2.6.2.19  finat_transp.c 

This  file  contains  one  procedure,  fhiat_transpose,  which  transposes  a  matrix  into  the 
resu/f  matrix.  ~ 

The  following  files  are  included: 

"stdio.h" 

"ctype-h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

''libmatrix.h" 


2.6.2.19.1  fmat_transpose 

This  routine  transposes  a  matrix  into  the  result  matrix. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

m  131131 

float 

Standard 

result  131 131 

float 

Standard 

1  Internal  Variables  1 

[Internal  Variable 

Type 

Where  Typedef  Declared 

II 1  1 II  III 

float 

Standard 

register  float 

Standard 

1  Calls  1 

Function 

Where  Described 

fmat  copy 

Section  2.6.2.12.1 

1  Called  by  1 

Function 

Where  Described 

fmat  check 

Section  2.6.2.11  fm  check.c 

Table  2.6-36:  fmat_transpose  Information. 
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2.6.2.20  fv_check.c 

This  file  contains  one  procedure,  fvec_check,  which  checks  to  see  that  a  vector  is 
normalized. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"Ubmatrix.h" 


2.6.2.20.1  fvec^check 

This  routine  checks  to  see  that  a  vector  is  normalized. 


1  Parameters  1 

■  Parameter 

Type 

Where  Typedef  Declared 

_ 

float 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

TRUE 

int 

is  normaiized 

FALSE 

Ini 

is  not  normaiized 

Calls 

Function 

Where  Described 

ea 

Sim  macros.h  (macro  definition) 

square 

Sim  macros.h  (macro  definition) 

Table  2.61-5’?:  fvec  check  Information. 
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2.6.2.21  fv_d_prod.c 

This  file  contains  one  procedure,  fvec_dot_j)rod,  which  computes  a  vector  dot  product 
and  returns  the  result.  " 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_inacros.h" 

"libmatrix.h" 


2.6.2.21.1  fvec_dot_prod 

This  routine  calculates  a  vector  dot  product  and  returns  the  result 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

v1f3l 

float 

Standard 

varaj 

float 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

temp 

register  float 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

temp 

float 

vector  dot  product  result 

Table  2.6>38:  fvec_dot_prod  Information. 
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2.6.2.22  fv_ni_inul.c 

This  file  contains  one  procedure,  fvec_inat_mul,  which  multiplies  a  vector  by  a  matrix 
and  stores  the  result  ^ 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math-h" 

"sim_dfns.h” 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.22.1  fvec_mat_mul 

This  routine  multiplies  a  vector  by  a  matrix  and  stores  the  result.. 


Parameters 


Parameter 


Where  Tyoedef  Declared 


Standard 


Standard 


Standard 


Internal  Variable 


vO 


v1 


v2 


resjptr 


vec  Dtr 


Internal  Variables 


static  float 


static  float 


state  float 


reoister  float 


reoister  float 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


Table  2.6>39:  fvec  mat  mul  Information. 
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2.6.2.23  fv_scale.c 

This  file  contains  one  procedure,  fvec_scaie,  which  scales  a  vector. 

The  following  files  are  included: 

"st<So.h" 

"ctype.h" 

'’math.h" 

"sim_dfhs.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.23.1  fvec_scale 
This  routine  scales  a  vector. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vr3i 

float 

Standard 

result  131 

float 

Standard 

scale  factor 

float 

Standard 

Table  2.6-40: 


fvec_scale  Information. 
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2.6.2.24  fv_x_prod.c 

This  file  contains  one  procedure,  fvec_cross_prod,  which  computes  a  vector  cross 
product  and  stores  the  result 

The  following  files  are  included: 

"st(So.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

’'Ubmatrix.h'' 

2.6.2.24.1  fvec_cross_prod 

This  routine  calculates  a  vector  cross  product  (v/  x  v2)  and  stores  the  result  The  right 
hand  rule  applies;  the  cross  product  sweeps  from  vi  to  v2. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Vlf31 

float 

Standard 

v2r31 

float 

Standard 

result  131 

float 

Standard 

Table  2.6*4 1: 


fvec_cross_prod  Information. 


2.6.2.25  fvec_add.c 

This  file  contains  one  procedure,  fvec_add,  which  adds  two  vectors. 

The  following  files  are  included: 

"sttfio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"Ubmatrix.h" 


2.6.2.25.1  fvec_add 
This  routine  adds  two  vectors. 


1  Parameters  i 

Parameter 

Type 

Where  Typedef  Declared 

v1[31 

float 

Standard 

V2131 

float 

Standard 

result  131 

float 

Standard 

Table  2.6*42:  fvec_add  Information. 
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2.6.2.26  fvec_copy.c 

This  file  contains  one  procedure,  fvec_copy,  which  copies  VECTOR  from  to  VECTOR 
to. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"fiin_dfns.h" 

"sim_types.h" 

"sim_niacros.h" 

"Ubmatrix.h" 


2.6.2.26.1  fvec_copy 

This  routine  copies  vector /rom  to  vector  to. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

from  131 

float 

Standard 

10  131 

float 

Standard 

Table  2.6*43:  fvec^copy  Information. 


fvec_dump 

This  file  contains  one  procedure,  fvec_dump,  which  dumps  a  vector  and  accompanying 
message  to  the  standard  output 

The  following  file:  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"Ubmatrix.h" 


2.6.2.27.1  fvec_dump 


This  routine  dumps  a  vector  and  accompanying  message  to  the  standard  output 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

str 

char 

Standard 

V 131131 _ 

float 

Standard 

Table  2.6-44:  fvec_dump  Information. 


1359 


Vehicles  CSQ 


BBN  Systems  and  Technologies 


2.6.2.28  fvec_noriiuc 

This  file  contains  one  poaendure,  fvec_noriiialize,  which  normalizes  a  vector. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h*’ 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"Ubmatrix.h" 


2.6.2.28.1  fvec_norin«iize 

This  routine  normalizes  a:  vector. 


1  Parameters  1 

Parameter  | 

Type 

Where  Typedef  Declared 

vI31  1 

float 

Standard 

result  f3]  ; 

1  float 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

temp 

reaister  double 

Standard 

res  ptr  ^ 

realster  float 

Standard 

vpt! : 

repister  float 

Standard 

Calls 

Function 

Where  Described 

Sim  macros.h  (macro  definition) 

Tablie  2.6>45:  fvec  normalize  Information. 
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2.6.2.29  fvec__sub.c 

This  file  contains  one  procedure,  fvec_sub,  which  subtracts  two  vectors. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros,h" 

"libmatrix.h" 


2.6.2.29.1  fvec_sub 

This  routine  subtracts  two  vectors. 


i  Parameters  1 

Parameter 

Tvne 

Where  Typedef  Declared 

v1[31 

float 

Standard 

V2[31 

float 

Standard 

result  131 

float 

Standard 

Table  2.6*46:  fvec_sub  Information. 


f 
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2.6.2.30  in_fix_in.c 

This  file  contains  routine,  iiiat_fix_inatrix,  which  restores  a  matrix  to  a  state  of  ortho¬ 
normality.  Axis  is  the  most  impbiwt  column  of  the  matrix. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

”libmatrix.h" 


2.6.2.30.1  mat  Hx  matrix 


This  routine  restores  a  matrix  to  a  state  of  orthonormality.  Axis  is  the  most  important 
column  of  the  matrix. 


1  Parameters  I 

Parameter 

Typo 

Where  Typedef  Declared 

mat 

T  MATRIX 

Sim  types. h 

axis 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

V  dot  w 

REAL 

Sim  types.h 

u 

VECTOR 

Sim  types.h 

V 

VECTOR 

Sim  types.h 

w 

VECTOR 

Sim  types.h 

temp 

VECTOR 

Sim  types.h 

r 

int 

Standard 

Calls 

Function 

Where  Described 

vec  normalize 

Section  2.6.2.65  .1 

vec  dot  prod 

Section  2.6.2.56  .1 

vec  scale 

Section  2.6.2.66  .1 

vec  add 

Section  2.6.2.59  ,1 

vec  cross  prod 

Section  2.6.2.68  .1 

Table  2.6’41:  mat  fix  matrix  Information. 
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2.6.2.31 


m  id  init.c 


This  file  contains  one  procedure,  iiiatjdent_init,  which  initializes  a  matrix  to  be  the 
identity  matrix.  “  “* 


The  following  files  are  included: 
"st^o.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.31.1  maMdenMnit 

This  routine  initializes  a  matrix  to  be  the  identity  noatrix. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

hn _ _ _ 

T  MATRIX 

Sim  tvpes.h 

Internal  Variables 

■  internal  Variable 

Type 

Where  Typedef  Declared 

Im  Dtr 

REAL 

Sim  tvpes.h 

Table  2.6*48:  mat  ident  init  Information. 


» 


1363 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.6.2.32  m  m  mul.c 


This  file  contains  one  procedure,  iiiatjmat_inul,  which  multiplies  two  matrices  and  stores 
the  result 


The  following  files  are  included: 
"stcSo.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.32.1  mat_mat_mul 

This  routine  multiplies  two  matrices  and  stores  the  result. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ml 

REAL 

sim  types. h 

m2 

T  MATRIX 

Sim  tvpes.h 

result 

T  MATRIX 

sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

m1  xO 

register  REAL 

sim  types.h 

m1  xl 

register  REAL 

sim  types.h 

ml  x2 

register  REAL 

sim  types.h 

res  mat 

T  MATRIX 

sim  types.h 

res  ptr 

register  REAL 

sim  types.h 

to 

register  long 

Standard 

from 

Ii  II  il  11  h  — — 

Standard 

Table  2.6*49:  mat  mat  mul  Information. 
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2.6.2.33  m  r  int2.c 


This  file  contains  one  procedure,  mat_rot_init2,  which  initializes  a  matrix  to  be  a  rotation 
matrix. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.33.1  mat_roMnit2 

This  routine  initializes  a  matrix  to  be  a  rotation  mauix.  Rotation  is  counter-clockwise  when 
viewed  along  a  positive  axis.  The  sine  of  the  angle  is  given,  instead  of  the  angle  itself. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

m 

T  MATRIX 

Sim  tvoes.h 

sin  theta 

REAL 

Sim  types. h 

rot.axis 

int 

Standard 

1  Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

cos  theta 

REAL 

Sim  tvpes.h 

m  ptr 

reoister  REAL 

Sim  tvpes.h 

Calls 

Function 

Where  Described 

abs 

Sim  macros.h  (macro  definition) 

square 

Sim  macros.h  (macro  definition) 

Table  2.6-50:  mat  rot  init2  Information. 
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2.6.2.34  m_trig_init.c 

This  file  contains  procedure  iiiat_trig_iiiit.  which  initializes  a  matrix  to  be  a  rotation 
matrix,  given  the  sine  and  cosine'bf  an  angle. 

The  following  files  are  included; 

••stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

''sim_macros.h" 

"libmatrix.h" 


2.6.2.34.1  mat_trig_init 

This  routine  initializes  a  matrix  to  be  a  rotation  matrix,  given  the  sine  and  cosine  of  the 
angle,  instead  of  the  angle  itself.  Rotation  is  counter-clockwise  when  viewed  along  a 
positive  axis. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

m 

T  MATRIX 

Sim  types. h 

sin  theta 

REAL 

Sim  tvpes.h 

cos  theta 

REAL 

Sim  tvpes.h 

rot  axis 

int 

Standard 

1  Internal  Variables  1 

internal  Variable 

Type 

Where  Typedef  Declared 

m  ptr 

reaister  REAL 

Sim  tvpes.h 

Table  2.6-51:  mat_trig_init  Information. 
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2.6.2.35  in_v_mul.c 

This  file  contains  procedure  inat_vec_mul,  which  multiplies  a  vector  by  a  matrix  and 
stores  the  result. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.35.1  mat_vec_mul 

This  routine  multiplies  a  vector  by  a  matrix  and  stores  the  result 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

m 

T  MATRIX 

Sim  types. h 

V 

VECTOR 

Sim  tvpes.h 

result 

VECTOR 

Sim  tvpes.h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

vO 

REAL 

Sim  tvpes.h 

Vl 

REAL 

Sim  tvpes.h 

v2 

REAL 

Sim  tvpes.h 

res  Dtr 

register  REAL 

Sim  tvpes.h 

vec  ptr 

register  REAL 

Sim  tvpes.h 

Table  2.6'52:  mat  vec  mul  Information. 
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2.6.2.36  mat  add.c 


This  file  contains  procedure  mat^add,  which  adds  two  matrices. 


The  following  files  are  included: 
"stdio.h" 

"ctype.h" 

"inath.h" 

"sim_dfns.h'' 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.36.1  mat_add 

This  routine  adds  two  matrices  and  stores  the  result. 


i  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ml 

T  MATRIX 

Sim  tvpes.h 

m2 

T  MATRIX 

Sim  tvpes.h 

result 

T  MATRIX 

sim  tvpes.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

ml  P 

register  REAL 

Sim  tvpes.h 

m2  P 

register  REAL 

simjvpes.h 

result  P 

register  REAL 

sim_  tvpes.h 

Table  2.6>53:  mat  add  Information. 
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2.6.2.37  mat_adj.c 

This  file  contains  (me  pnmedure,  inat_adjugate,  which  calculates  the  adjugate  matrix. 

The  following  files  are  included: 

"stcfio.h" 

"ctype.h" 

"math.h" 

''sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.37.1  inat_adjugate 

This  routine  calculates  the  adjugate  matrix. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

m 

T  MATRIX 

Sim  types. h 

result 

T  MATRIX 

Sim  types. h 

Table  2.6-54: 


mat_adjugate  Information. 
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2.6.2.38  mat^check.c 

This  file  contains  one  procedure,  iiiat_check,  which  checks  that  all  vectors  in  a  matrix  are 
nOTmalized.  ~ 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.38.1  mat_check 

This  routine  checks  that  all  vectors  in  a  matrix  are  normalized. 


Parameters 


Parameter 


T  MATRIX 


Where  Typedef  Declared 


sim  tvoes.h 


Internal  Variable 


Return  Value 


TRUE 


FALSE 


Function 


mat  CO 


vec  check 


Internal  Variables 


e 


T  MATRIX 


11373 


Where  Typedef  Declared 


Sim  tvoes.h 


Return  Values 


Meanin 


all  normalized 


not  all  normalized 


Calls 


Where  Described 


Section  2.6.2.39  .1 


Section  2.6.2.52  .1 


Table  2.6'55:  mat  check  Information. 
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2.6.2.39  i3iat_copy.c 

This  file  contains  one  procedure,  mat  copy,  which  copies  T_MATRIX^om  to 

T.MATRDC  to. 

The  following  files  are  included: 

"st(So.h" 

"ctype.h" 

"inath.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_inacros.h" 

”libmatrix.h" 


2.6.2.39.1  mat_copy 

This  routine  copies  T_MATRIX  firom  to  T_MATRIX  to. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

src 

T  MATRIX 

Sim  types. h 

dest 

T  MATRIX 

Sim  tvpes.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

to 

Iona 

Standard 

from 

J22a _ 

Standard 

Table  2.6-56:  mat_copy  Information. 
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2.6.2.40  mat  deter.c 


This  file  contains  one  procedure,  iiiat_detenninant,  which  returns  the  determinant  of  a 
matrix. 


The  following  files  are  included: 
"stdio.h" 

••ctype.h" 

"math.h" 

"sim_df^ns.h" 

"sim_types.h” 

"sim_macros.h" 

"Ubmatrix.h" 


2.6.2.40.1  mat_determinant 

This  routine  returns  the  determinant  of  a  matrix. 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

m 

T  MATRIX 

Sim  tvoes.h 

Return  Values 

Return  Value 

Type 

Meanina 

(m[0l[0rml1](1]*ml2l[2])  + 
(m[01{1]*m{1]l2rm{2]{01)  + 
(m[0]t2rml1][0]*ml2l(1l)  + 
(m(0][0J*m{iK2]*ml2Hi])  + 
(m[0llirml1K0]*ml2]l2])  + 
(mroir2rmriirirmr2iroi) 

REAL 

determinant  of  m 

Table  2.6-57: 


mat  determinant  Information. 
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2.6.2.41  inat_dump.c 

This  file  contains  one  procedure,  matjdump,  which  dumps  a  matrix  to  the  standarc 
output.  ~ 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"libmatiix.h" 


2.6.2.41.1  mat_dump 

This  routine  dumps  a  matrix  and  accompanying  message  to  the  standard  output. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

mat 

T  MATRIX 

Sim  tvoes.h 

str 

char 

Standard 

Table  2.6>58:  mat_dump  Information. 


2.6.2.42  mat_forin.c 

This  file  contains  one  procedure,  niat_fonn,  which  forms  a  T_MATRIX  from  an  axis  of 
rotation  and  an  angle.  ~ 

The  following  files  are  included: 

"sim_types.h" 

"math.h" 


2.6.2.42.1  mat_form 

This  procedure  forms  a  T_MATRIX  from  an  axis  of  rotation  and  an  angle. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

laxis 

VECTOR 

Sim  tvpes.h 

REAL 

Sim  tvpes.h 

c 

T  MATRIX 

Sim  tvpes.h 

sin  ana 

REAL 

Sim  tvpes.h 

cos  ana 

REAL 

Sim  tvpes.h 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

one  m  cos 

REAL 

Sim  tvpes.h 

11  sin 

REAL 

sim  tvpes.h 
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12  Sin 

REAL 

Sim  tvpes.h 

13  sin 

REAL 

Sim  types. h 

112 

REAL 

Sim  types. h 

113 

REAL 

Sim  types.h 

123 

REAL 

Sim  types.h 

Table  2.6-59:  mat  form  Information. 


2.6.2.43  maMdent.c 

This  file  contains  one  procedure,  mat_ident,  which  initializes  a  matrix  to  the  unity  matrix. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"sim_types.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h'' 

"libmatrix.h" 


2.6.2.43.1  mat  ident 


This  procedure  initializes  a  matrix  to  the  unity  matrix. 


BBN  Systems  and  Technologies 
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% 


2.6.2.44  maMnit.c 

This  file  contains  procedure  maMnit,  which  initializes  all  elements  of  a  matrix  to  zero. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"sim_types:h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.44.1  matjnit 

This  procedure  initializes  all  elements  of  a  matrix  to  zero. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

m 

T  MATRIX 

Sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

temp 

reaister  REAL 

Sim  types. h 

Table  2.6>61:  mat  init  Information. 
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2.6.2.45  mat_inv.c 

This  file  contains  one  procedure,  matjnverse,  which  calculates  the  inverse  of  a  matrix. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h” 

"sim_types.h" 

"math.h" 

"sim_dfns.h'' 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.45.1  mat  inverse 


This  procedure  calculates  the  inverse  of  a  matrix. 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

m 

T  MATRIX 

Sim  types. h 

result 

T  MATRIX 

Sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Where  Tvpedef  Declared 

tmp 

1  T  MATRIX 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

mat  adjuaate 

Section  2.6.2.38  .1 

mat  transpose 

Section  2.6.2.52  .1 

mat  scale 

Section  2.6.2.49  .1 

Table  2.6-62:  mat  inverse  Information. 


1376 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.6.2.46  mat_lev_init.c 

This  file  contains  one  procedure,  mat  level  init,  which  forms  a  T_MATRIX  whose  Y 
axis  is  given  and  whose  X  axis  is  parallel  to  3>e  ground. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

’'sim_types:h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.46.1  maMeveMnit 

This  routine  forms  a  T_MATRIX  whose  Y  axis  is  given  and  whose  X  axis  is  parallel  to  the 
ground. 

m  is  the  matrix  to  be  initialized,  v  is  the  normalized  vector  which  is  the  Y  axis  of  m.  mptr 
is  a  pointer  to  the  elements  in  m.  vptr  is  a  pointer  to  the  elements  in  v.  scale  is  a  pointer  to 
a  factor  used  to  normalize  the  X  axis. 

The  X  axis  is  found  by  taking  the  cross  product  of  v  and  the  unit  vector  perpendicular  to 
the  ground,  (001).  The  residt  must  be  normalired  so  scale  (the  magnitude  of  the  result)  is 
found.  If  scale  is  0,  v  is  pointing  straight  up  or  down.  In  this  case,  the  X  axis  is  defined 
to  lay  along  the  X  axis  of  the  parent  system. 

The  Y  axis  is  given,  so  v  is  copied  onto  m. 

The  Z  axis  is  the  cross  product  of  the  X  and  Y  axes.  Since  they  are  perpendicular,  the 
result  is  automatically  normalized.  It  turns  out  that  the  last  component  of  this  vector  is  the 
magnitude  of  the  cross  product  of  the  Y  axis  and  the  unit  vertical.  This  was  found  above 
and  stored  as  a  result  of  scale  being  set  as  a  pointer  to  m  12]  [2]. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

m 

T  MATRIX 

Sim  types. h 

V 

VECTOR 

Sim  types.h 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

motr 

register  REAL 

Sim  types.h 

register  REAL 

Sim  types.h 

1  scale 

register  REAL 

Sim  types.h 

Table  2.6-63:  mat  level  init  Information. 
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2.6.2.47  mat_r_init.c 

This  file  contains  one  procedure,  inat_rot_init,  which  initializes  a  matrix  to  be  a  rotation 
matrix.  ~ 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"sim_types.h" 

*'math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.47.1  mat_rot_init 

This  procedure  initializes  a  matrix  to  be  a  rotation  matrix.  Rotation  is  counter-clockwise 
when  viewed  along  a  positive  axis. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

m 

T  MATRIX 

Sim  types. h 

theta 

REAL 

Sim  types. h 

rot  axis 

int 

Standard 

Table  2.6-64:  mat  rot  init  Information. 
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2.6.2.48  mat_scale.c 

This  file  contains  one  procedure,  iiiat_scale,  which  scales  a  matrix. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"sim_types.h'' 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.48.1  mat_scale 

This  procedure  scales  a  matrix. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

mat 

T  MATRIX 

Sim  types.h 

result 

T  MATRIX 

Sim  types.h 

scale  factor 

REAL 

Sim  types.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

mat  0 

reorster  REAL 

Sim  types.h 

result  P 

register  REAL 

Sim  types.h 

Yable  i.6-65:  mat  scale  Information. 
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2.6.2.49  mat_sub.c 

This  file  contains  one  procedure,  matjsub,  which  subtracts  two  matrices. 


The  following  files  are  included: 
"stdio.h" 

"ctype.h" 

*’sim_types.h" 

••math.h" 

”sim_dfns.h" 

”sim_macros.h" 

•'Ubmatrix.h" 


2.6.2.49.1  matjsub 

This  procedure  subtracts  two  matrices. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

m1 

T  MATRIX 

Sim  types. h 

m2 

T  MATRIX 

Sim  tvpes.h 

result 

T  MATRIX 

Sim  tvpes.h 

Internaf  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

m1  P 

reaister  REAL 

Sim  types.h 

m2  P 

register  REAL 

Sim  types.h 

result  P 

register  REAL 

Sim  types.h 

Table  2.6'66:  mat  sub  Information. 
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2.6.2.50  inat_to_elr.c 

This  file  contains  one  procedure,  mat  to_elr,  which  converts  from  T_MATRIX  to 

E_PARAM. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"sim_types.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.50.1  mat_to_elr 

This  procedure  converts  from  T_MATRIX  to  E_PARAM.  The  Euler  parameter  is  made 
from  the  direction  cosine  matrix.  REAL.SMALL  is  defined  as  1.0e-3S. 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

C 

T  MATRIX 

Sim  tvoes.h 

e 

E  PARAM 

Sim  tvoes.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

denominator 

REAL 

Sim  tvoes.h 

Table  2.6-67:  mat  to  elr  Information. 
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2.6.2.51 


inat_transp.c 


This  file  contains  one  procedure,  inat_transpose,  which  transposes  a  matrix  into  the 
result  matrix.  ~ 


The  following  files  are  included: 
"stdio-h" 

"ctype.h" 

"sim_types.h" 

"math.h” 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.51.1  mat_transpose 

This  procedure  transposes  a  matrix  into  the  result  matrix. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

m 

T  MATRIX 

Sim  types.h 

result 

T  MATRIX 

Sim  types.h 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

temp 

T  MATRIX 

Sim  types.h 

register  REAL 

simjypes.h 

1  Calls  1 

Function 

Where  Described 

mat  copy 

Section  2.6.2.40  .1 

Table  2.6'68:  mat_transpose  Information. 
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2.6.2.52  new_in_in__mul.c 

This  file  contains  one  procedure,  ninat_mat_inul,  which  multiplies  two  matrices. 

The  following  files  are  included: 

"stdio.h" 

"ctype.h" 

"sim_types.h" 

"math.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.52.1  nmat_mat_mul 

This  procedure  multiplies  two  matrices  and  stores  the  result. 


1  Parameters  1 

Parameter 

Where  Tvnedef  Declared 

m1 

register  REAL 

Sim  types. h 

m2 

register  T  MATRIX 

Sim  types.h 

result 

T  MATRIX 

Sim  types.h 

I  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

m1  xO 

register  REAL 

sIm  types.h 

m1  x1 

register  REAL 

Sim  types.h 

ml  x2 

register  REAL 

Sim  types.h 

res  mat 

T  MATRIX 

Sim  types.h 

res  ptr 

register  REAL 

Sim  types.h 

to 

register  long 

Standard 

from 

register  long 

Standard 

Table  2.6-69:  nmat  mat  mul  Information. 
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2.6.2.53  v_cos_prod.c 

This  file  contains  one  procedure,  vec_cos_prod,  which  computes  the  cosine  of  the  angle 
between  two  vectors.  ~ 

The  following  files  are  included: 

"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

”sim_macros.h" 

''libmatrix.h" 


2.6.2.53.1  vec_cos_prod 

This  procedure  computes  the  cosine  of  the  angle  between  two  vectors. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Vl 

VECTOR 

Sim  types. h 

v2 

VECTOR 

Sim  tvpes.h 

1  internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

lent 

repister  REAL 

Sim  tvpes.h 

Ien2 

register  REAL 

Sim  tvpes.h 

vec  dot  prodO 

REAL 

Sim  tvpes.h 

result 

REAL 

Sim  tvpes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

result 

REAL 

cosine  of  the  angle  between 
v1  and  v2 

1  Calls  1 

Function 

Where  Described 

vec  dot  prod 

Section  2.6.2.56  .1 

Table  2.6-70:  vec_cos_prod  Information. 
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2.6.2.54 


v_dot_prod.c 


This  file  contains  one  procedure,  vec_dot_prod,  which  computes  the  vector  dot  product 
and  returns  the  result. 


The  following  files  are  included: 
"stdio.h" 

"ctypes.h" 

''math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.54.1  vec_dot_prod 

This  procedure  computes  the  vector  dot  product  and  returns  the  result. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Vl 

VECTOR 

Sim  types. h 

v2 

VECTOR 

Sim  tvpes.h 

1  internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

temp 

reaister  REAL 

Sim  types.h 

1  Return  Values  1 

Return  Value 

Meanina 

temp 

REAL 

dot  product  result 

Table  2.6-71:  vec_dot_prod  Information. 
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2.6.2.55  v__e_transf.c 

This  file  contains  one  procedure,  vec_elr_traiisform,  which  transforms  a  vector  by  an 

Euler  parameter.  ” 

The  following  files  are  included: 

"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types.h" 

"sim_dtfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.55.1  vec_elr_transform 

This  procedure  transforms  a  vector  by  an  Euler  parameter.  v_A  is  the  source  vector. 
A_to_B  is  the  Euler  parameter.  v_B  is  the  transformed  vector. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

V  A 

VECTOR 

Sim  types. h 

A  to  B 

E  PARAM 

Sim  types. h 

V  B 

VECTOR 

Sim  types.h 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

tempt 

VECTOR 

Sim  types.h 

temp2 

VECTOR 

1  Calls  1 

Function 

Where  Described 

vec  cross  prod 

Section  2.6.2.68  .1 

vec  scale 

Section  2.6.2.66  .1 

vec  add 

Section  2.6.2.59  .1 

Table  2.6*72;  vec_eIr_transform  Information. 
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2.6.2.56  v_in_mul.c 

This  file  contains  one  procedure,  vec_inat_mul,  which  multiplies  a  vector  by  a  matrix 
and  stores  the  result. 

The  following  files  are  included: 

"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.56.1  vec_inat_mul 

This  procedure  multiplies  a  vector  by  a  matrix  and  stores  the  result. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

V 

VECTOR 

Sim  tvDes.h 

m 

T  MATRIX 

Sim  tvpes.h 

result 

VECTOR 

Sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

vO 

static  REAL 

Sim  tvpes.h 

V1 

static  REAL 

Sim  tvpes.h 

v2 

static  REAL 

Sim  tvpes.h 

res  Dtr 

register  REAL 

Sim  tvpes.h 

vec  ptr 

register  REAL 

Sim  tvpes.h 

Table  2.6-73:  vec  mat  mul  Information. 
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2.6.2.57  vec_add.c 

This  file  contains  one  procedure,  vec_add,  which  adds  two  vectors. 

The  following  files  are  included: 

"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types" 

"sim_dfns,h” 

"sim_macros.h" 

''libmatrix.h" 


2.6.2.57.1  vec_add 

This  procedure  adds  two  vectors. 
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2.6.2.58  vec_check.c 

This  file  contains  one  procedure,  vec_check,  which  checks  to  see  if  a  vector  is 
normalized.  ~ 

The  following  files  are  included: 

"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.58.1  vec_check 

This  procedure  checks  to  see  if  a  vector  is  normalized. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

v 

VECTOR 

Sim  types. h 

1  Return  Values  1 

Return  Value 

Type 

Meanlnq 

TRUE 

int 

is  normalized 

FALSE 

int 

not  normalized 

1  Calls  1 

Function 

Where  Described 

eq 

Sim  macros.h  (macro  definition) 

square 

Sim  macros.h  (macro  definition) 

Table  2.6-V5:  vec  check  Information. 
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2.6.2.59 


vec_copy 


.c 


This  file  contains  one  procedure,  vec^copy,  which  copies  VECTOR  from  to  VECTOR  to. 


The  following  files  are  included; 
"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types" 

"sim_^ns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.59.1  vec_copy 


This  procedure  copies  VECTOR  from  to  VECTOR  to. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

from 

VECTOR 

Sim  tvpes.h 

to 

VECTOR 

Sim  types. h 

Table  2.6-76:  vec^copy  Information. 


2.6.2.60  vec_dump.c 


This  file  contains  one  procedure,  vec^dump,  which  dumps  a  vector  to  the  standard 
output.  ~ 


The  following  files  are  included; 
"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.60.1  vec_dump 

This  procedure  dumps  a  vector  and  accompanying  message  to  the  standard  output. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

V 

VECTOR 

sim  types. h 

str 

char 

Standard 

Table  2.6-77: 


vcc  dump  Information. 
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2.6.2.61  vec_init.c 

This  file  contains  one  procedure,  vec_init,  which  initializes  a  vector  to  zero. 

The  following  files  are  included: 

"stdio.h" 

"ctypes.h" 

"inath.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.61.1  vec_init 

This  procedure  initializes  a  vector  to  all  zeroes. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

V 

VECTOR 

Sim  types. h 

Table  2.6-78:  vec  init  Information. 


2.6.2.62 


vec_neg.c 


This  file  contains  one  procedure,  vec_neg,  which  computes  -v7. 


The  following  files  are  included: 
"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types" 

"sim_^ns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.62.1  vec_neg 
This  procedure  computes  -v/. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Vl 

VECTOR 

Sim  tvpes.h 

result 

VECTOR 

Sim  tvpes.h 

Table  2.6-79:  vec_neg  Information. 
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2.6.2.63  vec_norm.c 

This  file  contains  one  procedure,  vec_normaii%,  which  normalizes  a  vector. 

The  following  files  are  included: 

"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types.h" 

''sim_dfns.h" 

"sim_macros.h‘' 

"libmatrix.h" 


2.6.2.63.1  vec  normalize 


This  procedure  normalizes  a  vector. 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

V 

VECTOR 

Sim  types. h 

result 

VECTOR 

Sim  tvpes.h 

1  Internal  Variables  1 

Internal  Variable 

Where  Tvpedef  Declared 

temp 

register  double 

Standard 

res  ptr 

register  REAL 

Sim  tvpes.h 

vjatr 

register  REAL 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

ea 

Sim  macros.h  (macro  definition) 

Table  2.6>80:  vec  normalize  Information. 
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.6.2.64 


vec  scale.c 


This  file  contains  one  procedure,  vec_scale,  which  scales  a  vector. 


The  following  files  are  included: 
"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.64.1  vec  scale 


This  procedure  scales  a  vector. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

V 

VECTOR 

Sim  types. h 

result 

VECTOR 

scale  factor 

REAL 

Sim  types.h  I 

Table  2.6-81:  vec  scale  Information. 


2.6.2.65  vec_sub.c 

This  file  contains  one  procedure,  vec_sub,  which  subtracts  two  vectors  and  stores  the 

result. 

The  following  files  are  included: 

"stdio.h" 

"ctypes.h" 

"math.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"libmatrix.h" 

2.6.2.65.1  vec_sub 

This  procedure  subtracts  two  vectors  and  stores  the  result. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

V1 

VECTOR 

Sim  types.h 

v2 

VECTOR 

Sim  types.h 

result 

VECTOR 

Sim  types.h 

Table  2.6-82: 


vec  sub  Information. 
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2.6.2.66  vec_x_prod.c 


This  file  contains  one  piocediue,  vecjcross jprod,  which  computes  a  vector  cross  product 
and  stores  the  result. 


The  following  files  are  included: 
"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types,h" 

"sim_macros.h" 

"libmatrix.h" 


2.6.2.66.1  vec_cross_prod 

This  routine  computes  a  vector  cross  product  and  stores  the  result. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

v1 

VECTOR 

Sim  types. h 

v2 

VECTOR 

Sim  types.h 

result 

VECTOR 

Sim  types.h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

temp 

VECTOR 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

vec_  copy 

Section  2.6.2.61  .1 

Table  2.6-83:  vec_cross_prod  Information. 


2.6.2.67  libmatrix.h 

(simnel/release/src/libsrc/libniatrix/libmatrix.h) 

This  file  declares  the  routines  found  in  Ubmatrix  for  use  inside  and  outside  of  libmatrix. 
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2.6.3  libtimers 

(ysitnnei/release/src/libsrc/libtiiners  [libdmers]) 

This  CSU  contains  the  routines  which  initialize  the  elapsed  time  clock  at  the  startup  of  a 
simulation.  It  also  provides  functionality  for  an  alarm  clock  tool.  This  allows  for  the  timed 
sequencing  of  simulation  events. 


2.6.3. 1  t_cur_tick.c 

(ysimnetA«lease/srcAibsrc/libtimers/t_cur_tick.c) 

This  file  contains  one  procedure,  timers_get_current_tick,  which  returns  the  current 
elapsed  time  in  ticks.  ~  ~  ~ 

The  foUowing  files  are  included: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_(hfn.h" 

"timers.h" 

"timers_loc.h" 


2.6.3. 1 . 1  timers_get_current_tick 

This  procedure  returns  libtimers _elapsedjicks^  the  elapsed  time  in  ticks. 


1  Return  Values  I 

Return  Value 

Type 

Meanina 

libtimers  elaosed-ticks 

int 

elapsed  time  in  ticks 

Table  2.6>84:  timers_get_current_tickInformation. 
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2. 6. 3. 2  t_cur_tlme.c 

(7sin]net/telease/sic/libsrc/libtiinersA_cur_tick.c) 

This  file  contains  a  routine  which  determines  the  elapsed  time  in  seconds. 

The  following  files  are  included: 

’’stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_<tfn.h" 

"timers.h" 

"timers_loc.h" 


2. 6. 3. 2.1  timers_get_current_time 

This  procedure  returns  libtimers  elapsed  time,  the  elapsed  time  in  seconds. 


1  Return  Values  I 

Return  Value 

Tvne 

Meaning 

libtimers  elaosed  time 

REAL 

elapsed  time 

Table  2.6-85:  timers_get_current_time  Information. 


2. 6. 3. 3  t_data.c 

(./simnetAelease/src/Ubsrc/libtimers/t_data.c) 

This  file  contains  a  routine  which  returns  infcmnation  about  the  timers. 

The  following  files  are  included: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_dfn.h" 

"timers.h" 

"timersjoc.h" 


2. 6. 3. 3.1  timers_get_data 

This  procedure  returns  information  about  the  timers. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

libtimers  data 

REAL 

information  about  the  timers 

Tabic  2.6-86:  timers_get_data  Information. 
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2. 6. 3. 4  t_deI_proc.c 

(./simnet/release/src/libsrc/libtimers/t_del.c) 


This  file  contains  one  routine  which  sets  a  timer  to  delay  the  implementation  of  a  procedure 
for  a  specified  amount  of  time. 


The  following  files  are  included: 
"stdio.h" 

"sim_types.h" 

"sim_^ns,h" 

"timers_dfn.h" 

"timers.h" 

"timers_loc.h" 


2. 6. 3. 4.1  tiiners_delay_proc 

This  routine  sets  a  timer  to  delay  the  implementation  of  a  procedure  for  a  specified  anx>unt 
of  time,  ticks  is  the  time  delay,  proc  is  the  proceedure  of  interest. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ticks 

int 

Standard 

oroc 

PFI 

Sim  types. h 

necessary 

int 

Standard 

data 

REAL 

Sim  types. h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

index 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

-1 

int 

unable  to  set  timer 

index 

int 

the  timer  set 

I  Calls  I 

Function 

Where  Described 

timers  aet  timer 

Section  2.6.3.6.1 

Table  2.6-87:  timers_delay_proc  Information. 
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2. 6. 3. 5  t_free.c 

(ysiinnet/release/src/libsrc/libtiiners/t_free.c) 

This  file  contains  a  routine  which  frees  a  timer  and  resets  its  values  so  that  it  can  be  used 
again. 

The  following  files  are  included: 

"stdio.h" 

*'sim_types.h" 

"sim_dfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers_loc.h" 


2. 6. 3. 5.1  timers_free_timer 

This  procedure  contains  one  parameter,  index,  which  is  the  timer  number.  It  resets  the 
libtimersjimer_values  for  a  particular  timer  to  a  value  set  when  they  are  not  in  use. 

libtimersjimervaluesl  index]. ticks Jeft 

Ubtimersjimer_yalues[index].ticidng_status 

libtimers_timer_yalues[index].timeout_edge 

libtimers_timer_values[index].injise  Status 

libtimersjimefycdueslindex].stopped_status 

libtimersjimerjfalueslindex].proc 

libtimersjimer_values[index].data 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

index 

int 

Standard 

Table  2.6-88:  timers  free  timer  Information. 
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2.6.3.6  t_get  timer.c 

(ysiinnel;^lease/src/libsic/libtimers/t_get_timer,c) 

This  file  contains  a  routine  which  sets  the  tin^r. 

The  following  files  are  included: 

"stdio.h" 

"sim_types.h" 

"sim_(&hs.h" 

"timers_dfn.h" 

"timers.h" 

"timers_loc.h" 


2. 6. 3. 6.1  timers_get_timer 

This  routine  sets  the  timer,  if  given  the  number  of  ticks  required  to  set  the  time. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

hicks 

int 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

index 

int 

Standard 

in  use 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

-1 

int 

too  many  timers  already  set 

index 

int 

the  timer  that  is  set 

Table  2.6-89: 


timers_get_timer  Information. 
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2. 6. 3. 7  t_in  use.c 

(ysimnet/r3ease/src/libsic/libtimersA_in_use.c) 

This  file  contains  a  routine  which  deteimines  if  a  timer  is  in  use. 

The  following  files  are  included; 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_dEh.h" 

"timers.h" 

"timers  loc.h" 


2 . 6 . 3 . 7 . 1  timers_get_in_use_sta  tus 

This  routine  indicates  whether  or  not  a  timer  is  currently  in  use.  index  is  the  timer  of 
interest. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

libtimersjimer_values  [index] 
.in  use  status 

int 

the  timer’s  in  use  status 

FREE 

int 

timer  is  free 

Table  2.6-90;  timers_get_in_use_status  Information. 
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2.6.3.8  Mnit.c 

(ysimnetAelease/src/libsrc/libtiiners/t_iniLc.c) 

This  file  contains  a  routine  which  sets  the  initial  time  at  the  onset  of  the  simulaiton.  It 
initializes  all  timers  so  that  they  are  available  for  use. 

The  following  files  are  included: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers_loc.h" 

"sys/types.h" 

"sys/time.h" 


2. 6. 3. 8.1  timers_init 

This  routine  sets  the  initial  time  at  the  start  of  a  simulation  and  initializes  all  timers  so  that 
they  are  available  for  use.  If  a  Masscomp  machine  is  used,  the  start  time  is  set  by  calling 
ftime(&libtimers_start_time).  If  this  function  returns  -1,  the  starting  time  could  not  be 
set  If  a  Butterfly  machine  is  used,  the  start  time  is  set  equal  to  rtc. 


1  Internal  Variables  1 

Internal  Variable 

Where  Tvpedef  Declared 

timer  otr 

reqister  pointer  to  TIMER 

timers,  dfn.h 

index 

register  int 

Standard 

1  Internal  Variables  1 

1  Internal  Variable 

Where  Tvoedef  Declared 

Li _ _ _ 

int 

start  time  could  not  be  set 

1  Calls  1 

Function 

Where  Described 

(time  (if  Masscomp) 

Standard  C  function  available  on  the  Masscomp  Machine 

Table  2.6-91:  timers  init  Information. 


2. 6. 3. 9  Moc.c 

(./simnet/release/src/libsrc/libtimers/tjoc.c.c) 

This  file  declares  certain  local  variables  and  sets  values  to  some  of  them. 
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2.6.3.10  t^milli.c 

(ysimnei/rclease/src/libsn:/libtimers/t_milli.c) 

This  file  contains  one  routine  which  returns  the  elapsed  time  in  milliseconds. 

The  following  files  are  included: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers_loc.h" 

"net/network.h" 


If  a  Masscomp  machine  is  used,  "sys/types.h"  and  "sys/timeb"  are  also  included. 


2.6.3.10.1  timers_eIapsed_milliseconds 

This  procedure  determines  and  returns  the  elapsed  time  in  milliseconds. 


If  a  Masscomp  machine  is  used: 


Internal  Variables  I 

internal  Variable 

Type 

Where  Typedef  Declared 

current  real  time 

timed 

Masscomp  types 

diff  in  secs 

time  t 

Masscomp  types 

diti  in  millisecs 

unsianed  short 

Standard 

elapsed  millisecs 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

cam  get  real  time 

e'apsed  millisecs 

int 

elapsed  time  in  milliseconds 

Table  2.6-92:  timers_elapsed_miIIiseconds  Information  for  the  Masscomp. 


If  a  Butterfly  machine  is  used: 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

current  real  millisec 

long 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

current  real_millises  - 
libtimers  start  millisec 

int 

elapsed  time  in  milliseconds 

Table  2.6-93:  timers_elapsed_milliseconds  Information  for  the  Butterfly. 
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2.6.3.11  t_nulI_proc.c 

(ysimnet/telMse/src/libsrc/libtitners/t_null_proc.c) 

This  file  contains  a  routine  which  is  called  by  timers_delay_proc()  to  initialize  the 
proceedure  to  be  called  after  the  timer  has  expired. 

The  following  files  are  included; 

"stdio.h" 

’'sim_types.h" 

"sim_dfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers_loc.h" 

2.6.3.11.1  timers_null_proc 

This  routine  is  called  by  timers  de!ay_proc()  to  initialize  the  procedure  that  will  be 
called  when  the  timer  has  expireH.  ~ 


1  Return  Values  1 

Return  Value 

Tvoe 

Meanina 

0 

int 

null 

Table  2.6-94;  timers_nulI_proc  Information. 


2.6.3.12  t_reset.c 

(./simnet/rclease/src/libsrc/libtimers/t_reset.c) 

This  file  contains  a  routine  which  resets  the  timeout  edge  so  that  the  timer  can  be  reused. 

The  following  files  are  included; 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_dfn.h" 

"timers.h" 

"timersjoc.h" 

2.6.3.12.1  timers_reset_timeout_edge 

This  function  has  one  parameter,  index ,  which  represents  the  timer  of  interest.  This 
procedure  sets  the  libtimersjimer_values[ index] .  timeout  edge  to  OFF,  so  that  the  timer 
can  be  reused. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

index 

int 

Standard 

Table  2.6-95:  timers_reset_timeout_edge  Information. 


2.6.3.13  t  restart.c 
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(./simnet/release/src/libsrc/libtimers/t_restart.c) 

This  file  contains  a  routine  which  resets  the  stopped  status  of  the  timer  to  FOREGROUND. 

The  following  files  are  included; 

"stdio.h" 

"sim_types.h" 

"sim_(tfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers_loc.h" 

2.6.3.13.1  tiniers_restart_tiiiier 

This  routine  sets  the  stopped  status  of  the  timer  to  FOREGROUND.  This  causes  the  timer 
to  resume  elapsing  time.  This  function  has  one  parameter,  index ,  which  denotes  the  timer 
to  be  started. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

index 

int 

Standard 

Table  2.6-96:  timers  restart  timer  Information. 


2.6.3.14  t_set_null.c 

(./simnet/reiease/src/libsrc/lilmmers/t_set_null.c) 

This  file  contains  a  routine  which  sets  an  index  to  no  timer. 

The  following  files  arc  included: 

"stdio.h" 

"sim_types.h" 

"sim_(frns.h" 

"timers_dfn.h" 

"timers.h" 

"timers  loc.h" 


2.6.3.14.1  timers_set_null_tiimer 

This  routine  sets  an  index  to  no  timer  and  returns  an  indication  of  this. 


1  Return  Values  1 

Return  Value 

Meanina 

NULL  TIMER 

int  1 

index  set  to  no  timer 

Table  2.6-97:  timcrs  set  niiU  timer  Information. 

?-.6.3.15  tsimul.c 

(,./simnet/release/src/libsrc/libtiincrs/t  .suTinl.c') 
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This  file  contains  a  routine  which  keeps  all  of  the  timers  up  to  date. 

The  following  files  are  included; 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers_loc.h" 

''net/network.h" 


2.6.3.15.1  timers  simul 


This  routine  contains  the  functionality  to  coordinate  all  timers  and  keep  them  current. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedet  Declared 

timer  ptr 

reaister  pointer  to  TIM  ER 

timers  dfn.h 

index 

reaister  int 

Standard 

1  Calls  1 

Function 

Where  Described 

timers  free  timer 

Section  2.6.3.5.1 

Table  2.6-98:  timers  simul  Information. 


1405 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


% 


2.6.3.16  t_start.c 

(ysimnetAelease/src/libsrc/libtimers/t_startc) 


This  file  contains  a  routine  which  grabs  the  time  from  the  operating  system  to  set  the  start 
time  for  the  timers. 


The  following  files  are  included: 
"stdio.h" 

''sim_types.h" 

"sim_dfns.h" 

"timers_^n.h" 

•’timers.h" 

"timers_loc.h" 

''net/network.h" 


If  a  Masscomp  machine  is  used,  "sys/types.h"  and  "sys/timeb"  are  also  included. 


2.6.3.16.1  tiiners_init_starttiine 

This  procedure  initializes  the  start  time  for  all  timers  by  grabbing  the  current  time  from  the 
operating  system. 

If  a  Masscomp  machine  is  used,  the  function  ftiiiie(&libtimers_start_time)  is  called  to  set 
the  start  time  for  all  timers.  If  ftime  returns  -1,  the  start  time  couldn't  be  set. 


If  a  Butterfly  machine  is  used,  libtimers_startjniUi5ec  is  set  equal  to  rtc. 


1  Calls  1 

Function 

Where  Described 

ftime  (H  Masscomp) 

Standard  function  available  on  the  Masscomp. 

Table  2.6*99:  timers  ink  starttime  Information. 
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2.6.3.17  t_status.c 

(./sininetAielease/src/libsrc/libtimers/t_statuss.c) 

This  file  contains  a  procedure  which  determines  the  status  of  all  timers. 

The  following  files  are  included: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers_loc.h" 


2.6.3.17.1  timers_status 

This  procedure  prints  the  status  of  all  timers  in  use,  and  prints  the  number  of  timers 
counted.  This  is  a  debugging  tool. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Tvpedef  Declared 

ret 

int 

Standard 

i 

int 

Standard 

Table  2.6>100:  timers  status  Information. 


2.6.3.18  t_stop.c 

(./simnet/release/src/libsrc/libtimers/t_stop.c) 

This  file  contains  a  routine  which  allows  you  to  stop  a  timer. 

The  following  files  are  included: 

"stdio.h" 

"sim_types.h" 

"sim_(tfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers  loc.h" 


2.6.3.18.1  timers_stop_timer 


This  procedure  sets  the  value  of  libtimers  timer  values  I  index]  .  stoppedstatus  to 
STOPPED,  which  stops  that  particular  timer  designated  by  index. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

Table  2.6-101:  timers_stop_timer  Information. 
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2.6.3.19  t_stopped.c 

(7siinnetA«lease/src/libsrc/libtimers/t_stopped.c) 

This  file  contains  a  procedure  which  returns  the  stopped  status  of  a  timer. 

The  following  files  are  included: 

"stdio.h" 

"sim_types.h" 

"sim_(tfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers  loc.h" 


2.6.3.19.1  timers_get_stopped_status 

This  procedure  retuns  the  stopped  status  for  the  timer  specified  by  index. 


Parameter 


index 


I  Bn 


Parameters 


Where  Tvoedef  Declared 


Standard 


Return  Values 


Return  Value  Type 


libtimers_timer_values  (index]  int 
.  stopped  status 


FOREGROUND  int 


Meanln 


stopped  status  of  the  timer 


timer  is  runnin 


Table  2.6-102:  timers_get_stopped_status  Information. 
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2.6.3.20  t_ticking.c 

(ysimnetA'elease/src/libsrc/libtiniers/t_ticking.c) 

This  file  contains  a  procedure  which  returns  the  ticking  status  of  a  given  timer. 

The  following  files  are  included: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers  loc.h" 


2.6.3.20.1  timers_get_ticking_status 

This  routine  returns  the  ticking  status  of  a  timer  specified  by  index. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

index 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

libtimers_timer_values  [index] 
.tickinq  status 

int 

timer  status 

TiMED  OUT 

int 

timer  timed  out 

Table  2.6-103:  timers_get_tlcklng_status  Information. 


1409 


BBN  Systomf  and  Technologies 


Vehicles  CSCI 


2.6.3.21  fit_ticks.c 

(ysuxonetAelease/src/libsrc/libtiniers/t.ticks.c) 

This  file  conttains  one  procedure,  timers_get_ticks_leftO  which  returns  the  number  of 
ticks  lemainimg.  “  ~ 

The  following^  files  are  included: 

"stdia-h” 

"simjRypes.h" 

"sim_s^ns.h" 

"timer's_dfn.h” 

"timeL’^.h" 

"timers  loc.h" 


2.6.3.21  timers_get_ticksjeft. 

This  routine  xcstums  the  number  of  ticks  remaining  on  the  timer  designated  by  index. 


Parameter 


index 


I  on 


Parameters 


Where  Tvoedef  Declared 


Standard 


Return  Values 


Return  Valute  Tvoe 


libtimers_timer_values  [index]  int 
.ticks  ieft 


int 


Meanin 


the  number  of  ticks  left 


no  more  ticks  left 


Table  2.6-104:  timers_get_ticksjeft  Information. 
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2.6.3.22  t_tiineout.c 

(./simnet/release/src/libsrc/libtimers/t_timeout.c) 

Ihis  file  contains  a  routine  which  returns  the  timeout  edge  for  a  given  timer. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"timers_dfn.h" 

"timers.h" 

"timers_loc.h" 


2.6.3.22.1  timers_get_timeout_edge 

This  routine  returns  the  timeout  edge  for  a  given  timer.  The  routine  returns  TRUE  on  the 
tick  that  the  timer  went  off  and  returns  FALSE  otherwise. 


1  Parameters  1 

Parameter 

Where  Tvpedet  Declared 

index 

int 

Standard 

I  Return  Values  1 

Return  Value 

Type 

Meaning 

liblimers_timer_values  (index] 
.timeout_edge 

int 

TRUE  if  the  timer  went  off  on 
that  tick 

FALSE  if  timer  is  ticking  or  off 

0 

int 

timer  not  defined 

Table  2.6-105:  timers_get_timeout_edge  Information. 


2.6.3.23  timers_ioc.h 

(./simnet/release/src/libsrc/libtimersAimers_loc.h) 

This  file  declares  several  external  variables  for  use  in  routines  within  this  library. 
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2.6..  4  libutil 

(/simnet/release/sn^bsic/libudl  [libutil]) 

Thisf  Hbrary  contains  a  collection  of  utilities  which  include  clear  screen  and  produce  an 
aDdilble  prompt  This  library  also  contains  various  copy  procedures  and  formatted  and/or 
timeid  printing  routines. 

2.6. 4.1  beep.c 

(/simnet/release/src/libsrc/libutil/beep.c) 

Has  file  contains  one  procedure,  beep,  which  causes  an  audible  prompt  to  be  produced. 

2.6. 4. 1.1  beep 

This  routine  produces  an  audible  prompt  count  is  an  integer  which  is  used  as  a  counter. 


Parameter 


counfi 


lErn 


Parameters 


Where  Tvoedef  Declared 


Standard 


Table  2.6-106:  beep  Information. 


2.6.4.2  cp_2_TFl.c 

(/simnet/release/src/libsrc/libutil/cp_2_TF  1  .c) 

This  file  contains  one  routine,  copy_to_TFl,  which  copies  a  T_MATR1X  or  a  VECTOR  to 
aTF  l  structure. 

Incltsdes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

2.6. 4.2.1  copy_to_TFl 

This  routine  copies  a  T_MATRIX  or  a  VECTOR  to  a  TFl  structure,  srcjntx  is  a  source 
matrix  of  type  T_MATRIX.  src  vec  is  a  source  vector  of  type  VECTOR,  dst  is  a  pointer 
to  thte  destination  TFl. 


Parameters 


Parameter 


src  «7TtX 


src  wee 


dst 


T  MATRIX 


VECTOR 


inter  to  TFl 


irs 


Where  Tvpedef  Declared 


sim  types. h 


Sim  types. h 


sim  ciQ  if.h 


Internal  Variable 


1173 


Internal  Variables 


Where  Tvoedef  Declared 


Standard 


Standard 


TabI'  ?.6-l07:  copy_to_TFl  Information. 
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22.6.4.5  cp  TFl.c 

(/sininet^lease/src/libsrc/libutil/cp_TFl  .c) 

'IThis  file  contains  one  routine,  copy_TFl,  which  copies  a  source  matrix  and  vector  to 
(destination  matrix  and  vector.  ~ 

'IThe  following  are  included: 

"sim_types.h" 

"mass_stdc.h" 

”dgi_stdg.h" 

"sim_cig_if.h" 

22.6.4.5.1  copy_TFl 

Tlhis  routine  copies  source  matrix  and  vector  to  destination  matrix  and  vector,  src  is  a 
pointer  to  the  source  TFl  matrix,  dst  is  a  pointer  to  the  destination  TFl  matrix. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

src 

pointer  to  TFl 

sim  ciQ  if.h 

dist 

pointer  to  TF1 

Sim  CiQ  if.h 

1  Internal  Variables  I 

linternal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

j _ 

int 

Standard 

Table  2.6-109:  copy_TFl  Information. 


^.6.4.6  cp  TF2.C 

(/simnet^elease/src/libsrc/libutil/cp_TF2.c) 

'The  following  are  included: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


22.6.4.6.1  copy_TF2 


'•This  routine  copies  a  source  vector  to  a  destination  vector,  src  is  a  pointer  to  the  source 
'jTF2  vector,  and  dst  is  a  pointer  to  the  destination  TF2  vector. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

3irc 

pointer  to  TF2 

sim  ciq  if.h 

(Sst 

pointer  to  TF2 

sim  ciq  if.h 

’  ihle  2.6-110:  copy_TF2  Information. 
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2. 6. 4. 7  cp  Xrot2TF2.c 

(/simnet^lease/src/libsrc/libutil/cp_Xrot2TF2.c) 

This  file  contains  a  routine  which  copies  a  T_MATRIX  matrix  to  a  TF2  matrix. 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2. 6. 4. 7.1  copy_X_rot_to_TF2 

The  following  routine  copies  a  T_MATRIX  matrix  (src)  to  a  TF2  matrix  (dst). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

src 

T  MATRIX 

Sim  types. h 

dst 

pointer  to  TF2 

Sim  ciQ  if.h 

Table  2.6-111:  copy_X_rot_to_TF2  Information. 


2. 6. 4. 8  cp  Yrot2TF2.c 

(/simnet/release/src/libsrc/libutil/cp_Yrot2TF2.c) 

This  file  contains  a  routine  which  copies  a  matrix  of  type  T_MATRIX  to  a  matrix  of  type 
TF2. 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 


2. 6. 4. 8.1  copy_Y_rot_to_TF2 

The  following  routine  copies  a  matrix  of  type  T_MATRIX  {src)  to  a  matrix  of  type  TF2 
(dst). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

src 

T  MATRIX 

Sim  types. h 

dst 

pointer  to  TF2 

sim  ciQ  if.h 

Table  2.6-112:  copy_Y_rot_to_TF2  Information. 
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2. 6. 4. 9  Cfp  Zrot2TF2.c 

(/simneai/?elease/src/libsrc/libutU/cp_Zrot2TF2.c) 

This  file  contains  a  routine  which  copies  a  matrix  of  type  T_MATRIX  to  a  TF2. 

Includes: 

"sim_ty[pes.h" 

"mass_?stdc.h" 

"dgi_stdg.h" 

"sim_dig_if.h" 


2. 6. 4. 9.1  ♦copy_Z_rot_to_TF2 

The  following  Eoutine  copies  a  T-MATTUX  (src)  to  a  matrix  of  type  TF2  (dst). 


Parameter 


src 


dst 


Parameters 


e 


T  MATRIX 


inter  to  TF2 


IE2T! 

ID 

m 


Where  Tvoedef  Declared 


sim  tvDes.h 


Sim  cia  if.h 


Table  2.6-113:  copy_Z_rot_to_TF2  Information. 

2.6.4.10  daatabase.c 

(/simnetVrelease/src/libsrc/IibutU/database.c) 

This  file  contafsns  routines  which  handle  database  names. 

Includes: 

"strings.h" 

"ctype..h" 

The  following  iis  declared: 
databa.N»e_in_use[  1 4] 

2.6.4.10.1  u  t  i  l_set_data  base_naine 

This  routine  tr.anslates  a  database  name  into  a  standard  format  string,  db  is  a  pointer  to  the 
database  name:. 


Parameter 


db 


lEJI^ 


Parameters 


inter  to  char 


Where  Tvoedef  Declared 


Standard 


Internal  Variables 


Internal  Varl&oie 


Where  Tvoedef  Declared 


Standard 


Table  2.6-114:  util  set  database  name  Information. 
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2.6.4.10.2  util_get_database_name 


This  routine  gets  the  name  of  the  database  in  use. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

database  in  use 

pointer  to  char 

name  of  database  in  use 

Table  2.6>115:  util_get_database_name  Information. 


2.6.4.11  dead_zone.c 

(/simneiAelease/src/libsrc/libutil/dead_2one.c) 

This  file  contains  a  routine  which  adds  a  "dead  zone"  to  a  control. 

Includes: 

"sim_types.h" 

"sim_macros.h" 

"sim_dfns.h" 

2.6.4.11.1  add_dead_zone 

This  routine  adds  a  zone  where  the  controls  don’t  respond,  control  is  the  control  to  be 
changed  and  deadjtone  is  the  range  to  be  designated  as  a  "dead  zone." 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

control 

REAL 

Sim  types. h 

dead  zone 

REAL 

Sim  types,  h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

control 

REAL 

sim.types.h 

1  Calls  1 

Function 

Where  Described 

max 

Sim  macros.h  (macro  definition) 

min 

Sim  macros.h  (macro  definition) 

Table  2.6-116:  add  dead  zone  Information. 
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2.6.4.12  deg.c 

(/simnet^lease/src/libsrc/libutil/deg.c) 

This  file  contains  a  routine  which  generates  an  angle  given  its  sine  and  cosine. 

Includes; 

"sim_types.h" 

"sim_macros" 

”sim_dfns.h" 

The  following  are  defined: 

S_C_45 

COEFF_3 

CX)EFF_1 

2.6.4.12.1  sin_cos_to_deg 


This  routine  returns  the  angle  (in  degrees)  given  the  sine  and  cosine  of  that  angle,  s  is  the 
sine  of  the  angle  and  c  is  the  cosine  of  the  angle. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedel  Declared 

s 

REAL 

Sim  types. h 

c 

REAL 

Sim  types. h 

Return  Values 

Return  Value 

Type 

Meaning 

((COEFF  3*  s*s  + 

COEFF  1)*s) 

REAL 

the  angle  in  degrees  for 
angles  between  -45°  and  45° 

((COEFF  3*C*C  + 

COEFF_1)  *0-90.0) 

REAL 

the  angle  in  degrees  for 
angles  between  -135°  and 
-45° 

((-COEFF  3*C*C- 
COEFF  1)*c  +  90.0) 

REAL 

the  angle  in  degrees  for 
angles  between  45°  and  135° 

((-COEFF  3  *  s  *  s  - 
COEFF_1)*s  + 180.0) 

REAL 

the  angle  in  degrees  for 
angles  between  135°  and 

180° 

((-COEFF  3*S*S-COEFF  1) 

*  s  -180.0) 

REAL 

the  angle  in  degrees  for 
angles  between  -180°  and 
-135° 

Table  2.6-117:  sin_cos_to_deg  Information. 


2.6.4.13  dumpcore.c 

(/sininet/release/src/libsrc/libutiI/dump_core.c) 

rh:s  tile  contains  a  nmtine  which  purposely  dumps  core. 
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2.6.4.13.1  dump_core 

This  routine  purposely  dumps  the  core. 


Internal  Variable 


a 


IB7!I 


Internal  Variables 


Where  Tvoedef  Declared 


Standard 


Table  2.6-118:  duinp_core  Information. 


2.6.4.14  error_printf.c 

(/simnet/release/src/libsTc/libutil/eiTor_4)rintf.c) 

This  file  contains  a  routine  which  prints  an  error  report. 

Includes: 

"stdio.h" 


2.6.4.14.1  error_printf 

This  routine  prints  a  report,  function  jtame  is  the  function  name  where  the  error  occurred. 
ctl  is  the  printout  control.  args[]  is  the  list  of  arguments.  text[150}  is  the  string  to  form  the 
message  in. 


Parameters 


Parameter 


function  name 


ctl 


e _ 

Where  Typedef  Declared 

DO 

inter  to  char 

Standard 

inter  to  char 

Standard 

int  1 

Standard 

Internal  Variables 


Internal  Variable 


Where  Tvoedef  Declared 


Standard 


Table  2.6-119:  error_printf  Information. 


2.6.4.15  format.c 

(/simnet/rclease/src/libsrc/libutil/formaLc) 

This  file  contains  routines  that  when  given  a  buffer,  a  format  string,  and  a  pointer  to  a 
variable  list  of  arguments,  will  then  fill  the  buffer  with  an  ascii  string  that  corresponds  to 
the  argument  list^  in  the  format  string  format  These  routines  are  compiler  dependent  due 
to  the  nature  of  compiler  differences  in  processing  functions  and  operands. 

Function  strchr  ()  checks  for  existence  of  a  string  by  checking  the  value  of  pointer  s . 
Function  find  arg  type  ()  parses  a  format  string  of  the  type  passed  to  any  formatted 
output  from  pffntf.Tprintf,  or  sprintf.  It  then  returns  an  appropriate  argument  type 
ARG  type  depending  on  the  value  passed  to  it. 
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Utility  function  format  decoder  ()  is  the  top  level  routine  in  this  program  which  does  the 
equivalent  of  sprintf,  placing  a  formatted  string  in  a  character  array.  Input  arguments  to 
format_decoder  ()  are  a  pointer  to  an  allocated  buffer,  a  format  string  and  a  pointer  to  a 
list  of  arguments  (as  midsized  by  va  start  (list).  Why  not  use  sprintf  ?  Because  it  WILL 
NOT  accept  a  pointer  to  an  argument  list  Therefore,  it  can’t  be  called  by  a  routine  that  has 
arguments  passed  to  it  from  a  variable  argument  list  such  as  timed_printf  or  error jjrintf. 

Before  this  utility  was  provided,  a  funciton  called  _doprnt  was  used.  Since  this  is  NOT 
guaranteed  to  exist  in  any  C  implementation,  a  compiler  independent  and  machine 
independent  function  is  required  to  satisfy  portability  requirements. 

Function  copybuf  copies  string  characters  between  two  pointers  (start  and  end)  to  output 
buffer  bitf . 

Includes: 

"stdio.h" 

"strings.h" 

"ctype.h" 

"varargs.h" 

Defines; 

ARG.NONE 

ARG_CHAR 

ARG_POINTER 

ARG_INT 

ARG.LONG 

ARG.FLOAT 

ARG_DOUBLE 

2.6.4.15.1  strchr 

Function  strchr  ()  checks  for  the  existence  of  a  string,  c,  by  checking  the  value  of  pointer 
s.  Ifs  is  not  zero  (false),  it  then  returns  the  contents  of  the  string  s. 


Parameter 


s 


c 


I  Em 


inter  to  char 


char 


Parameters 


Where  Typedef  Declared 


Standard 


Standard 


Return  Value 


s 


Return  Values 


e 


static  pointer  to  char 


static  pointer  to  char 


Meanin 


the  contents  of  the  strin 


strino  is  \alse 


Table  2.6-120:  strchr  Information. 
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2.6.4.15.2  find_arg_type 

Function  find  arg  type  ()  parses  a  fonnat  string  of  the  type  passed  to  any  formatted 
output  finom  pnntf,7printf,  or  sprintf.  It  then  returns  an  appropriate  argument  type 
ARG  type  depending  on  the  value  passed  to  it. 


Parameter 


s 


IEI7? 

irs 


Parameters 


inter  to  char 


Where  Typedef  Declared 


Standard 


Internal  variable 


Internal  Variables 


inter  to  char 


inter  to  extern  char 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Return  Value 


ARG  NONE 


ARG  POINTER 


ARG  CHAR 


ARG  LONG 


ARG  INT 


ARG  DOUBLE 


ARG  FLOAT 


Return  Values 


e 


static  int 


static  int 


static  int 


static  int 


static  int 


static  int 


static  int 


Meanin 


default 


a  Dointerwas  oassed 


a  char  was  passed 


a  Iona  was  passed 


an  int  was  passed 


a  double  was  passed 


a  float  was  passed 


Function 


strchr 


Calls 


Where  Described 


Section  2.6.4.15.1 


Table  2.6-121:  find_arg_type  Information. 
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2.6.4.15.3  format_decoder 

This  is  the  top  level  routine  for  this  utility.  Given  a  pointer  to  a  buffer  (that  you  have 
allocated),  a  format  string  and  a  pointer  to  a  list  of  args  (as  initialized  by  va_start)  this 
routine  will  do  the  equivalent  of  an  sprintf. 

Defines; 

WORKSPACE_SlZE 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

but  addr 

pointer  to  char 

Standard 

fmt 

pointer  to  char 

Standard 

1  Internal  and  External  VarlabI 

ies 

Variable 

Where  Typedef  Declared 

start  next  fmt 

pointer  to  char 

Standard 

end  next  fmt 

pointer  to  char 

Standard 

workspace 

pointer  to  char 

Standard 

str  size 

int 

Standard 

done 

int 

Standard 

int 

Standard 

int  ara 

int 

Standard 

double  arg 

double 

Standard 

long  arg 

long 

Standard 

pointer  to  char 

Standard 

copybufO 

static  void 

Standard 

stfChrO 

pointer  to  extern  char 

Standard 

malloc 

pointer  to  extern  char 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

str  size 

int 

size  of  buffer 

1  Calls  1 

Function 

Where  Described 

strchrt 

Section  2.6.4.15.1 

find  arg  type 

Section  2.6.4.15.2 

Table  2.6-122:  format_decoder  Information. 
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2.6.4.15.4  copybuf 

This  function  copies  string  characters  between  two  pointers  {start  and  end)  to  output  buffer 
buf . 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

buf 

pointer  to  char 

Standard 

start 

pointer  to  char 

Standard 

end 

pointer  to  char 

Standard 

2.6.4.16  libutil.h 

(/simnet/release/src/libstc/libutil/libutil.h) 

The  following  routines  are  declared  to  be  external: 
duinp_core() 
sin_cos_to_deg() 
add]_dead_zone() 


2.6.4.17  pr  R4P3D.C 

(/simnet^lease/src/libsrc/libutil/pr_R4P3D.c) 

This  file  contains  one  routine,  print_R4P3D(),  which  prints  an  R4P3D. 

The  following  are  included: 

"stdio.h" 

"siin_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.6.4.17.1  print_R4P3D 

This  routine  prints  an  R4P3D  matrix. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

rp 

pointer  to  R4P3D 

dai  stdQ.h 

s 

char 

Standard 

Table  2.6*124;  prInt_R4P3D  Information. 
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2.6.4.18  pr  TFl.c 

(/simnei;^lea»e/src/libHic/libuti]/pr_TF  1  .c) 

This  faie  contains  one  proceedure,  print_TFl(),  which  prints  a  TFl  matrix. 


The  fyiowing  are  included: 
"stdio.h" 

"sim_types.h" 

"mass_stdc.h"’ 

”dgi_stdg.h” 

"sim_cig_if.h'" 

2.6.4.18.1  print_TFl 

This  procedure  prints  ;a  TFl  matrix. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

tf 

*90inter  to  TF1 

Sim  ciQ  if.h 

s 

e^ar 

Standard 

1  Internal  Variables  1 

Interivai  Variable 

Where  Tvpedef  Declared 

i 

int 

Standard 

j _ 

-»nt 

Standard 

Table  2.6-125:  print_TFl  Information. 


2.6.4.19  pr  TF2.C 

(/simnet/^leasse/src/Iibsrc/libutil/pr_TF2.c) 

This  file  contains  one  routine,  print_TF2(),  which  prints  a  TF2  matrix. 

The  following  are  included: 

"stdio.h" 

"sim_types.h'" 

"mass_stdc.h  ’ 

"dgi_.stdg.h" 

"sim_  cig_if.h  ’ 

2.6.4. 19. J  print_TF2 

This  routine  prints  a  "]rF2  mati  ix. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t1 

poiriter  to  TF2 

Sim  ciq  it.h 

s 

char 

Standard 

Ta’i'r  .6' '26:  print  TFZ  Information. 
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2.6.4.21  strtok.c 

(/simnetA«lease/src/libsrc/libutil/strtok.c) 

This  file  provides  the  functionality  of  the  standard  Berkeley  C  file  strtok.c.  It  was  written 
because  the  Butterfly  does  not  run  with  Beikeley  C.  These  routines  are  not  defined  for  the 
Masscomp. 

The  following  are  declared: 

♦strtokO 

*strtok_skip() 

*strtok”find() 


2.6.4.21.1  strtok^skip 


This  routine  examines  a  string. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

str 

pointer  to  char 

Standard 

col 

pointer  to  char 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

D 

pointer  to  char 

Standard 

J 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

P 

pointer  to  char 

ran  out  of  column  chars 

{(char)Ol 

pointer  to  char 

all  matched 

Table  2.6-127:  strtok_skip  Information. 
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2.6.4.21.2  strtok  find 


This  routine  finds  a  string  specified  by  str,  given  a  token  to  parse  on  (col).  It  returns  an 
indicadon  of  success  or  failure. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

str 

pointer  to  char 

Standard 

col 

pointer  to  char 

Standard 

I  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

0 

pointer  to  char 

Standard 

3 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

P 

pointer  to  char 

matched 

((char)O) 

pointer  to  char 

no  match 

Table  2.6-128:  strtok  find  Information. 


2.6.4.21.3  strtok 


This  routine  parses  a  string  and  passes  it  back  to  the  user.  It  contains  the  same 
functionality  of  the  stand^d  C  call  strtok. 


Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

str 

pointer  to  char 

Standard 

col 

pointer  to  char 

Standard 

Internal  Variables  1 

Internal  Variable 

Where  Tvpedef  Declared 

P 

pointer  to  char 

Standard 

temp  p 

pointer  to  char 

Standard 

3 

pointer  to  char 

Standard 

Return  Values  1 

Return  Value 

Type 

Meaning 

l(char)O) 

pointer  to  char 

the  string  is  logically  egual  to  0 

tmp  p 

pointer  to  char 

parsed  string 

str 

pointer  to  char 

parsed  string 

Calls 

Function 

Where  Described 

strtok  skip 

Section  2.6.4.21.1 

strtok  find 

Section  2.6.4.21.2 

Table  2.6-129:  strtok  Information. 


1426 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.6.4.22  t_mat_dump.c 

(/simnet/release/src/libsrc/libuti]/t_mat_dump.c) 

This  file  contains  one  routine,  timed_mat_dump,  which  dumps  a  matrix  to  the  standard 
output  at  a  specified  time. 

2.6.4.22.1  timed_mat_dump 

This  routine  dumps  a  matrix  to  the  standard  output  at  a  specified  time. 


Parameters 


Parameter 


str 


mat 


char 


T  MATRIX 


Where  TvDedet  Declared 


Standard 


sim  tvoes.h 


Function 


timed  orintf 


Calls 


Where  Described 


Section  2.6.4.24.1 


Table  2.6-130:  timed_mat_dump  Information. 


2.6.4.24  t_vec_dump.c 

(/simnet/release/src/libsrc/libutil/t_vec_dump.c) 

This  file  contains  one  routine,  timed_vec_dump,  which  dumps  a  vector  to  the  standard 
output  at  a  specified  time.  ”  ” 

2.6.4.23.1  tlmed_vec_dump 

This  routine  dumps  a  vector  to  the  standard  output  at  a  specified  time. 


Parameter 


str 


Parameters 


e 


char 


VECTOR 


ID71I 


Where  Typedef  Declared 


Standard 


Sim  tvoes.h 


Function 


timed  onntf 


Calls 


Where  Described 


Section  2.6.4.24.1 


Table  2.6-131:  timed_vec_dump  Information. 
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2.6.4.24  timed_printf.c 

(/simnet/rclease/src/libsrc/libudl  [libutil]) 

This  file  contains  a  routine  which  prints  out  at  a  specified  time. 

Includes; 

"stdio.h" 

"timers.h" 

The  following  is  declared; 
interval 


2.6.4.24.1  timed_printf 

This  routine  prints  out  every  interval  ticks,  ctl  is  the  printout  control,  and  args[ ]  is  the  list 
of  arguments. 


Parameter 


ctl 


lEIT!! 

irs 


Parameters 


inter  to  char 


Where  Tvoedet  Declared 


Standard 


Standard 


Function 


timers  qet  current  tick 


Calls 


Where  Described 


Section  2.6.3.1.1 


Table  2.6-132:  timed_printf  Information. 


2.6.4.24.2  timed_printf_set 

This  routine  sets  the  printing  interval. 


Parameter 


val 


Where  Tvoedet  Declared 


Standard 


Table  2.6-133:  timed  printf  set  Information. 
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2.6.5  libshm 

(/simnet/rclease/src/libsrc/libshm  [libshm]) 

Libshm  provides  facilities  for  mapping  in  regions  of  shared  memory.  It  encapsulates  a 
sequence  of  system  calls  into  a  single  uniform  interface.  Shared  memory  segments  are 
us^  in  the  SIMI^T  simulations  to  provide  shared  access  by  (potentially)  multiple 
processes  to  memory  buffers  used  to  communicate  with  I/O  devices. 

A  shared  memory  segment  is  attached  to  by  calling  attachshmQ.  which  takes  as 
arguments  a  key  (identifier),  segment  size  in  bytes,  and  a  flag  that  specifies  whether  or  not 
to  create  the  segment.  A  process  can  detach  from  a  segment  by  calling  detachshm().  A 
shared  memory  segment  may  be  removed  by  calling  removeshm(). 


2.6.5. 1  attach.c 

(/simnet/release/src/libsrc/libshm/attach.c) 

This  file  comtains  one  procedure,  attachshm,  which  attaches  to  a  shared  memory 
segment. 

Includes: 

"stdio.h* 

"fcntl.h" 

"ermo.h" 

"sys/types.h;" 

"sys/pc.h" 

"sys/shm.h" 

"sys/sem.h" 

"signal.h" 

"shmcontrol.h" 
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2. 6. 5. 1.1  attachshm 


This  routine  is  called  to  attach  the  shared  memory  associated  with  the  key  (of  size  size 
bytes)  to  the  calling  piwess.  The  shared  segment  is  created  if  the  creat^ag  is  TRUE  and 
the  segment  doesn't  exist.  If  the  flag  is  FALSE  and  the  segment  doesn't  exist,  this  routine 
fails  and  returns  a  null  pointer. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

kev 

int 

Standard 

size 

int 

Standard 

createflaa 

int 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Tvpedef  Declared 

sbtkO 

pointer  to  char 

Standard 

CP 

pointer  to  char 

Standard 

id 

int 

Standard 

shmat 

pointer  to  char 

Standard 

D 

pointer  to  char 

Standard 

i 

int 

Standard 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

NULL 

char 

routine  failed 

P 

'Winter  to  char 

address  of  shared  memory 
segment  that  you  are 
attachinq  to 

Table  2.6-134; 


attachshm  Information. 


1430 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2. 6. 5. 2  detach.c 

(/simnetAclease/src/libsrc/libshin/detach.c) 

This  file  comtains  one  procedure,  detachshm,  which  detaches  from  the  shared  memory 
segment. 


Includes: 


"stdio.h* 

"fcntl.h'’ 

"ermo.h" 

"sys/types.h:" 

"sys/pc.h" 

"sys/shm.h" 

"sys/sem.h" 

"signal.h" 

"shmcontrol.h" 


2. 6. 5. 2.1  detachshm 


This  routine  detaches  the  shared  memory  at  the  argument  address  from  the  calling  process. 
It  returns  0  if  successful  and  -1  otherwise. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

shmaddr 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Tvne 

Meaning 

-1 

int 

routine  failed 

0 

int 

routine  succeeded 

Table  2.6*135:  detachshm  Information. 
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2.6.5.3  remove.c 

(/simnet/release/src/libsrc/libshm/rcmove.c) 

This  file  contains  one  procedure,  removeshm,  which  removes  the  shared  memory 
segment. 


Includes: 


"stdio.h* 

"fcnti.h’’ 

"ermo.h" 

"sys/types.h:" 

"sys/pc.h" 

"sys/shm.h" 

"sys/sem.h" 

"signahh" 

"shmcontrol.h" 


2. 6. 5. 3.1  removeshm 


This  routine  removes  the  shared  memoruy  specified  by  the  key  from  the  calling  process.  It 
returns  0  if  successful  and  -1  otherwise. 


II  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

key 

int 

Standard 

size 

int 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

id 

int 

Standard 

flaas 

int 

Standard 

1  Return  Values  1 

Return  Value 

Tvoe 

Meanina 

-1 

int 

routine  failed 

0 

int 

routine  succeeded 

Table  2.6-136:  removeshm  Information. 


2. 6. 5. 4  shmcontrol.h 

(/common/libsource/libshm/shmcontrol.h) 

The  following  are  declared  for  use  outside  of  libshm; 

attachshmO 

detachshmO 

removeshmO 
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2.6.6  libmove 

(./simnet/release/src/libsrc/libmove  [libmove]) 

libmove  contains  utilities  for  moving  data.  It  exists  to  support  moving  data  to^m  lA^ 
devices  that  place  restrictions  on  the  types  of  access  suppt^ed  and  to  provide  performance 
enhancements  for  operating  system  and  hardware  platforms  whose  native  facilities  were 
found  to  be  suboptimal.  lihese  routines  are  written  in  assembly  language. 
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2.6.7  libser 

(ysinmetill^lease/sic/libsic/libser  [libser]) 

libser  provides  access  to  the  heartbeat  function  of  the  HPSM  serial  card  used  to  intoface  to 
the  IDC  boards.  The  heartbeat  is  periodically  checked  to  detect  whether  the  card  has  failed. 

2. 6. 7.1  iral  mein_dfn.h 

(7siinneh)re^ase/sr^bsrc/libser/ml_mem_dfn.h) 

A  number  of  v^ables  are  declared  as  external  for  use  in  libshm. 


2. 6. 7. 2  aser  status.c 

(ysimnco5telease/src/libsrc/libser/ser_status.c) 

This  file  containis  functions  which  are  used  to  determine  if  the  HPSM  serial  card  has  failed. 
Ser  heartbeat  iinit  is  called  to  initialize  access  to  the  heartbeat  location,  while 
ser^cartbeat  us  called  to  obtain  the  heartbeat  value. 

heartbeat  is  decfiared  as  static  short 

2. 6. 7. 2.1  arer_heartbeat 

This  routine  is  oalled  to  obtain  the  heartbeat  value.  It  returns  TRUE  if  the  current  value  of 
the  location  in  Inost  memory  that  is  continually  incremented  by  the  HPSM  card  software  has 
changed  since  tfee  last  call  to  this  routine.  It  returns  FALSE  otherwise.  This  routine  should 
not  be  called  m[»x  often  than  about  once  per  second  to  make  sure  that  the  HPSM  card  has 
had  time  to  increment  the  status  word.  It  shoud  be  called  at  least  once  each  minute  to 
minimize  the  pcessibility  of  missing  a  change  due  to  roll  over. 


1  Internal  Variables  1 

Internal  Varlahde 

Type 

Where  Typedef  Declared 

new  heartbeat 

short 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

TRUE 

int 

current  value  in  location  of 
shared  memory  has  changed 

FALSE 

int 

current  value  in  location  of 
shared  memory  has  not 
changed 

Table  2.6-137:  ser  heartbeat  Information. 


2. 6. 7. 2. 2  iser_heartbeat_init 

This  routine  is  mitializcd  for  monitoring  ser_heartbeat().  It  must  be  called  before  calling 
ser_heartbeat(  V  heartbeat  is  initialized  to  pser  heartbeat. 
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2.6.8  libfifo 

(./simnetAelease/src/libsrc/libfifo  [libfifo]) 

libfifo  provides  an  interface  for  sending  output  to  a  serial  device.  It  allows  the  user  to 
queue  up  to  128  messages,  each  with  a  length  of  up  to  10  bytes.  Routines  are  provided  to 
create  a  queue,  enqueue  a  message,  and  send  all  messages  currently  on  the  queue  to  a 
serial  device.  This  interface  is  used  by  libsound  (see  section  2. 1.3.1)  and  libidc  (see 
section  2.1.4.1.1). 


2.6.8. 1  f_dequeue.c 

(ysimnet/release/src/libsrc/libfifo/f_dequeue.c) 

This  file  contains  a  routine  which  moves  messages  along  the  message  queue. 
Includes: 

"stdio.h" 

"fcntl.h" 

"sim_dfns.h" 

"fifo_dfn.h" 

"fifo.h" 


Defines: 

FIFO.DEBUG 

2. 6. 8. 1.1  fifo_dequeue 

This  routine  removes  messages  from  the  message  queue.  If  the  queue  is  not  empty,  the 
length  of  the  current  message  is  returned,  and  the  pointer  is  moved  to  the  next  message.  If 
the  queue  is  empty,  this  routine  returns  a  0. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fifop 

pointer  to  FIFO 

lifo  dfn.h 

butp 

pointer  to  char 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

lenath 

Int 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

0 

int 

the  queue  is  empty 

lenath 

int 

the  length  of  the  buffer 

Calls 

Function 

Where  Described 

FIFO  EMPTY 

Section  2.6.8  8 

NEXT  OUT 

Section  2.6.8  8 

Table  2.6-138:  fifo_dequeue  Information. 
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2.6.S.2  f_enqueue.c 

(ysimnetAelease/src/[ibsrc/libfifo/f_enqueue.c) 

This  file  contains  a  routine  which  sends  a  message  to  the  message  queue. 
Includes: 

"stdio.h" 

"fcntl.h" 

"sim_dfns.h" 

Tifo_dfn.h" 

Tifo.h" 


2. 6. 8. 2.1  fifo_enqueue 

This  routine  sends  a  message  to  die  message  queue,  given  the  message  string,  the  string 
length,  and  the  pointer  to  the  FIFO  port  that  the  message  is  to  be  sent  to.  This  routine  is 
called  by  output  producing  routines. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

fjfop 

pointer  to  FIFO 

fifo  dfn.h 

strina 

pointer  to  char 

Standard 

lenoth 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Tvoedef  Declared 

sccptr 

char 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

FALSE 

boolean 

full  fifo  port 

fifo  messaae  too  Iona 

TRUE 

boolean 

messaae  sent  to  output  port 

Calls 

Function 

Where  Described 

FIFO  FULLIfifOP) 

Section  2.6. 8.8 

NEXT  IN(fifop) 

Section  2.6.8. 8 

Table  2.6-139:  fifo_enqueue  Information. 
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2. 6. 8. 3  Mnit.c 

(ysimnet/release/src/libsrc/libfifo/f_iniLc) 

This  file  contains  a  routine  which  initializes  the  fifo  interface. 

2. 6. 8. 3.1  fifo_init 

This  routine  initializes  the  FIFO  segment  of  shared  memory,  given  a  pointer  to  the  FIFO 
array  and  a  port  number  This  routine  is  called  by  processes  Aat  initializes  shared  memory. 


Parameters 


Where  Tyoedef  Declared 


fifo  dfn.h 


Standard 


Table  2.6-140:  fifojnit  Information. 
2. 6. 8. 3. 2  fifo_uninit 

This  routine  is  not  defined  for  a  Masscomp  or  Butterfly  machine. 


2.6.8.4  f_open_^out.c 

(./siinhet/release/src/libsrc/libfifo/f_open/c) 

The  following  files  are  included: 

"stdio.h" 

"strings.h" 

"fcntl.h" 

"sim_dfns.h" 

Tifo_dfn.h" 

"fifo.h" 

The  following  are  defined; 

FIFO.DEBUG 

2. 6. 8. 4.1  open_up_output_port 

This  routine  opens  an  output  port  specified  by  fifop.  It  is  similar  to  a  UNIX  open. 


If  a  Butterfly  machine  is  used: 


Parameter 


Parameters 


inter  to  FIFO 


Where  Tvoedef  Declared 


fifo  dfn.h 


Return  Values 


Return  Value 


FALSE 


boolean 


Meanin 


couldn't  ooen  the  outout 


Table  2.6-141:  open_up_output_port  Information  for  the  Butterfly. 
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If  a  Masscomp  machine  is  used; 


Parameters 


Parameter 


inter  to  FIFO 


Where  Tvpedef  Declared 


fifo  dfn.h 


Internal  Variable 


lEin 


Internal  Variables 


Where  Tvpedef  Declared 


Standard 


Return  Values 


Return  Value 


TRUE 


FALSE 


boolean 


boolean 


Meanin 


rt  ooened 


couldn't  open  fifo 


Table  2.6-142:  open_up_output_port  Information  for  the  Masscomp. 

2. 6. 8. 4. 2  ciose_output_port 

This  routine  isn't  used  by  the  Masscomp  or  Butterfly. 

2. 6. 8. 5  f_print.c 

"(./simnet/release/src/libsrc/libfifo/Lprint.c) 

This  file  contains  a  routine  which  prints  information  about  the  fifo  interface. 

The  following  arc  included: 

"stdio.h" 

"fcntlh" 

"sim_dfns.h" 

"fifo.dfn.h" 

"fifo.h" 


2. 6. 8. 5.1  fifo_print 

This  routine  prints  information  about  the  fifo  interface.  It  is  used  as  a  debugging  tool. 


Parameters 


Parameter 


inter  to  FIFO 


Where  Tvpedef  Declared 


fifo  dfn.h 


internal  Variable 


IDTX 


Internal  Variables 


Where  Tvpedef  Declared 


Standard 


Table  2.6-143;  fifo  print  Information. 
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2. 6. 8. 6  f_send_out.c 

(7simnet/release/src/libsrc/libfifo/f_send_outd) 

This  file  contains  a  routine  which  sends  message  strings  to  an  output  port. 

Includes: 

"stdio.h" 

"fcnU.h" 

"sim_dfns.h" 

"fifo_dfn.h" 

"fifo.h" 


2. 6. 8. 6.1  send_output_to_port 

This  routine  repeatedly  calls  fifojdequeue  and  takes  the  message  in  the  queue  and  writes  it 
to  the  output  port  If  die  message  is  sent,  the  routine  returns  TTIUE  ,  and  if  no  message  is 
sent,  the  routine  returns  FALSE.  This  routine  is  not  used  by  the  Butterfly. 


1  Parameters 

Parameter 

Where  Typedef  Declared 

fifop 

pointer  to  FIFO 

fifo  dfn.h 

1  Internal  Variables  ! 

Internal  Variable 

Where  Tvpedef  Declared 

lenqth 

int 

Standard 

buffMESSAQE  SIZE1 

char 

Standard 

wrote  somethina 

boolean 

Standard 

1  Return  Values 

Return  Value 

Tvoe 

Meaning 

wrote_something 

boolean 

if  TRUE,  wrote  message  to 
output  port 

if  FALSE,  message  not  sent 

1  Calls 

Function 

Where  Described 

fifo  .dequeue 

Section  2.6.8.1.1 

Table  2.6-144:  send_output_to_port  Information. 


2. 6. 8.7  fifo.h 

(./simnet/release/src/libsrc/libfifo/fifo.h) 

This  file  declares  the  following  procedures  to  be  external: 
fifo_init() 
fifo~print() 
fifo~enqueue() 
fifo~dequeueO 
open_up_output_port() 
send_output_to_port() 
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2.6. 8. 8  fifo_dfn.h 

(ysimnei/release/src/libsrc/libfifo/fifo_dfn.h) 

The  following  macros  are  defined; 

NEXT_IN 

NEXT_OUT 

FIFO.EMPTY 

FIFO_FULL 

The  FIFO  structure  is  defined. 
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2.6.9  libevent 

(ysimnetAielease/src/libsrc/libevent  [libevent]) 

Event  IDs  are  used  to  distinguish  packets  that  are  sent  out  on  the  network.  Routines  for 
generating  a  unique  event  ID  is  contained  in  libevent 


2.6.9.1  event.c 

(ysimnet/release/src/libsrc/libevent/eventc) 

This  file  contains  routines  which  generate  a  unique  event  ID, 
Includes: 

"stdio.h" 

"math.h" 

"sim_drfn.h" 

"sim_macros.h" 

"types.h" 

The  following  is  declared: 
eventy_counter 


2. 6. 9. 1.1  event_init_eventid 

This  procedure  initializes  the  event  counter.  new_event_cnt  is  the  event  ID  to  start 
numbering  from. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

new  event  cnt 

long  int 

Standard 

Table  2.6-145:  event  init  eventid  Information. 


2. 6. 9. 1.2  event_get_eventid 

This  procedure  sequences  to  the  next  event  skip  indicates  the  number  of  events  to  be 
skipped. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

skip 

int 

Standard 

i  Return  Values  1 

Return  Value 

Type 

Meaning 

event  counter 

long  int 

the  id  of  the  next  event 

Table  2.6-146:  event_get_eventid  Information. 
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2.6.9.2  libevenL^ 

(ysimnet/release/^/libsrc/libevent/libevenLh) 


The  following  are  de&ieid: 
SKIP 
NO.SKIP 
NO_EVENT 
NO_AGENT 


The  following  are  declaretd  to  be  external: 
event_init_eve«itid() 
event_get3'‘«nitid() 
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2.6.10  libveh 

(Vsimnei/release/src/vehicle/libsrc/libveh  [libveh]) 

Libveh  provides  a  number  of  functions  which  return  information  about  other  vehicles.  The 
available  information  includes  the  type  of  vehicle,  its  role  on  the  battlefield  and  which  side 
"  the  battle  it  is  on,  Libveh  provides  the  ability  to  set  the  force  of  the  simulated  vehicle  for 
comparison  with  other  vehicles.  Libveh  is  the  only  CSU  required  to  perform  these  tasks. 


2.6.10.1  is_air_veh.c 

(ysimnet/rclease/src/vehicleAibsrc/libveh/is_air_veh.c) 

This  file  contains  a  routine  which  determines  if  the  vehicle  in  question  is  an  air  vehicle. 
Includes: 

"sim_dfns.h" 

"basic.h" 

"obj_type.h" 


2.6.10.1.1  is__air_vehicle 

This  routine  returns  TRUE  if  the  specified  vehicle  is  an  air  vehicle.  Otherwise,  it  returns 
FALSE. 


1  Parameters  1 

1  Parameter 

Where  Typedef  Declared 

ObieclType 

p  sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

vehicle  is  an  air  vehicle 

FALSE 

int 

vehicle  is  not  an  air  vehicle 

Table  2.6-147:  is  air  vehicle  Information. 
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Z..^.10.2  is_ammo_veh.c 

(ysimnet/release/src/vehicle/libsic/libveh^s_ammo_veh.c) 

Ihiis  file  contains  routines  which  determine  if  the  vehicle  in  question  is  an  ammunition 
caimer. 

indudes: 

"sim_dfns.h" 

"pro_sim.h" 

"obj_type.h" 

"veh_type.h" 


2..6. 10.2.1  is_ammo_vehicle 

This  routine  indicates  whether  or  not  a  vehicle  is  an  ammunition  carrier.  It  returns  a  pointer 
to  ihe  vehicle  appearance  variant. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pointer  to 

Vehicle  AppearanceVariant 

p_sim.h 

1  Return  Values  I 

Return  Value 

Type 

Meanina 

pkt~> 

caipabilities.ammunitionSupply 

int 

indication  of  whether  or  not 
the  vehicle  carries 
ammunition. 

1  means  the  vehicle  carries 
ammo 

0  means  the  vehicle  doesn’t 
carry  ammo 

Table  2.6-148:  is  ammo  vehicle  Information. 
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2.6.10.2.2  is_ammo_carrier 

This  routine  determines  if  the  vehicle  in  question  is  an  American  ammunition  carrier.  It 
returns  TRUE  if  this  is  the  case  and  returns  FALSE  otherwise. 


Parameter 


e 


IE273 


ObiectTvoe 


Parameters 


IR 


where  Typedef  Declared 


sim.h 


Return  Values 


Return  Value 


TRUE 


FALSE 


Meanin 


the  vehicle  is  an  American 
ammunition  carrier 


the  vehicle  is  not  an  American 
ammunition  carrier 


Table  2.6-149:  is  ammo  carrier  Information. 


2.6.10.3  is_anti  air.c 

(./simnet/releas^src/vehicle/libsrc/libvehAs_anti_air.c) 

This  file  contains  a  routine  which  determines  if  the  vehicle  in  question  is  an  antiaircraft 
vehicle. 


Includes: 


"sim_dfns.h" 

"basic.h" 

"obj_type.h" 


2.6.10.3.1  is  anti  aircraft 


This  routine  returns  TRUE  if  the  specified  vehicle  is  an  antiaircraft  vehicle.  Otherwise,  it 
returns  FALSE. 


Parameter 


e 


BR 


lEin 


ObiectTvoe 


Parameters 


m 


Where  Typedef  Declared 


sim.h 


Return  Values 


Return  Value 


TRUE 


FALSE 


Meanin 


vehicle  is  an  antiaircraft  vehicle 


vehicle  is  not  an  antiaircraft 
vehicle 


Table  2.6-150:  is  anti  aircraft  Information. 
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2.6.10.4  is_apc.c 

(ysimnet^lease/src/vehicle/libsrc/libveh^s_apc.c) 


This  file  contains  a  routine  which  determines  if  the  vehicle  in  question  is  an  armored 
personnel  carrier. 


Includes: 

"sim_dfns.h" 

"basic.h" 

"obj_type.h" 


2.6.10.4.1  is_personnel_carrier 

*  This  routine  returns  TRUE  if  the  specified  vehicle  is  an  armored  personnel  carrier. 

Otherwise,  it  returns  FALSE. 


1  Parameters  1 

■  Parameter  1 

Where  Typedef  Declared 

ObiectType 

p  sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

vehicle  is  an  armored 
personnel  carrier 

FALSE 

int 

vehicle  is  not  an  armored 
personnel  carrier 

Table  2.6*151:  is_personnel_carrier  Information. 
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2.6.10.5  ls_att_rwa.c 

(ysimnet^lease/src/vehicle/libsrc/libveh/is_att_iwa.c) 

This  file  contains  a  routine  which  determines  if  the  vehicle  in  question  is  an  attack  rotary 
wing  airoafi  (helicopter). 

Includes; 

"sim_dfns.h" 

"basic.h" 

"obj_type.h" 


2.6.10.5.1  is_attack_rwa 


This  routine  returns  TRUE  if  the  specified  vehicle  is  an  attack  rotary  wing  aircraft 
(helicopter).  Odierwise,  it  returns  FALSE. 


1  Parameters  1 

1  Parameter  1 

Where  Tvpedef  Declared 

ObiectType 

D  sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

ini 

vehicle  is  an  attack  rotary  wing 
aircraft 

FALSE 

int 

vehicle  is  not  an  attack  rotary 
wing  aircraft 

Table  2.6-152:  is  attack  rwa  Information. 
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4 


2.6.10.6  is_friend.c 

(ysimnet/release/src/vehicle/libsrc/libvehAs_frien(i.c) 

This  file  contains  routines  which  determine  if  a  vehicle  is  friendly,  set  a  vehicle's  force  id, 
and  returns  a  vehicle's  force  id. 

Includes: 

stdio.h" 

"sim_types.h" 

"sim_<tfns.h" 

"pro_sim.h" 

"veh_type.h" 

The  variable  our  Jorce  is  declared. 

2.6.10.6.1  is_friendly 


This  routine  determines  if  a  vehicle  is  friendly,  that  is,  if  a  vehicle  is  on  your  side  or  if  it  is 
a  target  vehicle,  his  Jorce  is  the  force  id.  K  the  vehicle  is  friendly,  the  routine  returns 
TRlfe.  Otherwise,  it  returns  FALSE. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

his  torce 

ForcelD 

basic.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

vehicle  is  friendly 

FALSE 

int 

Table  2.6-153:  is_friendly  Information. 


2.6.10.6.2  veh  set  force 


This  routine  changes  the  force  id  of  a  vehicle,  new  Jorce  is  the  new  force  id  of  the  vehicle. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

new  force 

ForcelD 

basic.h 

Table  2.6-154:  veh  set  force  Information. 


2.0,10.6.3  veh_get_force 

Th".  routine  returns  the  force  id  of  our  vehicle. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

our  force 

ForcelD 

our  force  id 

Table  2.6-155:  veh  gct  forcc  Information. 
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2.6.10.7  is_fuel  veh.c 

(./simnei;Aielease7srcA^ehicle/libsrc/libvehAs_fuel.c) 

This  file  contains  a  routine  which  determines  if  a  vehicle  is  a  fuel  supply  truck. 
Includes: 

"sim_dfns.h" 

"pro_sim.h" 


2.6.10.7.1  is  fuel  vehicle 


This  routine  returns  a  pointer  to  the  vehicle  appearance  variant  to  indicate  whether  or  not  a 
vehicle  is  a  fuel  supply  truck. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pkt 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

pkt->  capabiiities.FuelSupply 

int 

indicates  if  vehicle  carries  fuel. 

1  means  it  is  a  fuel  truck 

0  means  it  is  not  a  fuel  truck 

Table  2.6«156:  is_fuel_vehicle  Information. 
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2.6.10.8  is^fwa.c 

(ysiinnei/release/srcA^ehicle/libsrc/libveh^s_fwa.c) 


This  file  contains  a  routine  which  determines  if  the  vehicle  in  question  is  fixed  wing 
aircraft. 


Includes: 

"sim_dfns.h" 

"basic.h" 

"obj_type.h" 


2.6.10.8.1  is_fwa 

This  routine  returns  TRUE  if  the  specified  vehicle  is  a  fixed  wing  aircraft.  Otherwise,  it 
returns  FALSE. 


I  Parameters  1 

1  Parameter  1 

Where  Typedef  Declared 

ObiectTvpe 

p  sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

TRUE 

int 

vehicle  is  a  fixed  wino  aircraft 

FALSE 

int 

vehicle  is  not  a  fixed  wing 
aircraft 

Table  2.6-157:  is  fwa  Information. 
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2.6.10.9  is_inb_tank.c 

(7simnet^lease/src/vehicle/libsrc/libvehAs_mb_tank.c) 

This  file  contains  a  routine  which  determines  if  the  vehicle  in  question  is  a  main  battle  tank. 
Includes: 

"sim_dfns.h" 

"basic.h" 

"obj_type.h" 


2.6.10.1.1  is  air  vehicle 


This  routine  returns  TRUE  if  the  specified  vehicle  is  a  main  battle  tank.  Otherwise,  it 
returns  FALSE. 


1  Parameters  1 

1  Parameter 

Where  Typedef  Declared 

ObiectTvpe 

p  sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

vehicle  is  a  main  battle  tank 

FALSE 

int 

vehicle  is  not  a  main  battle  tank 

Table  2.6<158:  is  main  battle  tank  Information. 
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X.t6.10.10  is_rep_veh.c 

(ysimnet/rclease/src/vehicleAibsrc/libveh  As_rcp_veh.c) 


IMs  file  contains  a  routine  which  determines  if  a  vehicle  is  a  repair  vehicle. 


deludes: 


"sim_dfns.h" 

"pro_sim.h" 


2.6.10.10.1  is_repair_vehicle 

TSiis  routine  returns  a  pointer  to  the  vehicle  appearance  variant  to  indicate  if  the  vehicle  in 
qfuestion  is  a  repair  vehicle. 


1  Parameters  1 

Parameter 

Where  Typedet  Declared 

pkt 

pointer  to 

Vehicle  AppearanceVariant 

p_sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

pkt->  capabitities.repair 

int 

indicates  if  vehicle  is  a  repair 
vehicle 

0  means  the  vehicle  is  not  a 
repair  vehicle 

1  means  the  vehicle  is  a  repair 
vehicle 

Table  2.6-159:  is_repair_vehicle  Information. 
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2.6.10.11  is_rwa.c 

(7simnet/rclease/src/vehicle/libsrc/libveh^s_rwa.c) 

This  file  contains  a  routine  which  determines  if  the  vehicle  in  question  is  a  rotary  wing 
aircraft. 

Includes; 

"sim_dfns.h" 

"basic.h" 

"obj_type.h" 


2.6.10.11.1  is  rwa 


This  routine  returns  TRUE  if  the  specified  vehicle  is  a  rotary  wing  aircraft  Otherwise,  it 
returns  FALSE. 


1  Parameters  1 

■  Parameter  1 

Where  Tvpedef  Declared 

ObiectTvpe 

p  sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

vehicle  is  a  rotary  wing  aircraft 

FALSE 

int 

vehicle  is  not  a  rotary  wing 
aircraft 

Table  2.6-160:  is  rwa  Information. 


2.6.10.12  libveh.h 

(./simnet/release/src/vehicle/libsrc/libveh/libveh.h) 

This  file  contains  declarations  of  the  following  functions  which  are  used  in  "libveh": 
is_ammo_vehicle() 
is~fuel  vehicIeO 
is~repair_vehicie() 
is~main_battle_tank() 
is_pers6hnel_cirrier() 
is”anti_aircrift() 
is”air_vehicle() 
is”priority_vehicle() 
is~attack_rwa() 
is~fwa()  ” 

map_othervehs_net_id_to_mycig_id() 
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2.6.11  libmap 

(simnetAelease/sic/libsic/libmap  [libmap]) 


The  dynamic  models  and  effects  displayed  by  the  cig  are  contained  in  the  dynamic  element 
database  (DED).  There  are  256  possible  models  and  256  possible  effects.  Each 
model/effect  is  assigned  an  8-bit  index  from  0-255.  The  assignment  of  model/effect  indices 
is  specific  to  a  particular  DED. 


The  SIMNET  protocols  use  a  method  of  specifying  models  and  ammunition  types  which  is 
independent  of  that  of  the  cig.  It  uses  a  32-bit  integer  where  adjacent  groups  of  bits  contain 
hierarchical  information  about  the  object  being  described. 

The  library,  "libmap,"  contains  routines  which  map  model  and  effect  definitions  from  the 
SIMNET  protocol  description  to  the  cig  index  and  visa  versa.  In  addition,  it  also  maps 
information  specified  by  the  protocol  appearance  field  to  bits  defined  in  the  cig  interface  to 
describe  enhancers  (Application  Specific  Identifiers  or  ASIDs)  for  the  models.  These 
include  features  such  as  dust  clouds,  flaming,  and  smoking.  The  ASID  field  in  the  cig 
interface  also  allows  one  to  specify  a  3  character  bumper  number  for  which  each  character 
can  be  0-9,  A-D,  H,  or  a  blank. 

"Libmap"  reads  in  3  files,  one  which  describes  the  ASID  bits,  one  which  indicates  the 
mapping  from  SIMNET  protocol  vehicles  to  cig  models  and  one  which  indicates  the 
mapping  for  SIMNET  protocol  ammunition  types  to  their  corresi»nding  effects  as  well  as 
damage  files.  The  file  names  are  specified  in  a  parameter  file  which  is  read  in  during 
startup. 


2.6.11.1  damage.c 

(./simnet/release/src/libsrc/libmap/damage.c) 


This  file  contains  routines  which  check  to  see  if  the  appropriate  damage  files  exist.  If  they 
do  exist,  the  damage  files  are  read  in.  For  each  vehicle,  damage  files  exist  for  various 
ammunition  types. 


The  following  files  are  included: 
"stdio.h" 

"signal.h' 

"ctype.h" 

"sim_types.h" 

"sim_(frns.h" 

"sim_macros.h" 

"libmap_dfn.h" 

"libmap.h" 

"libfail.h" 


The  following  is  defined: 

NO^DAMAGE.  TABLE_INDEX 


following  are  declared  ext  *mally: 
ded_map_entriesl  i 
number_of_entrie.s 


last_.in_ammo_class|  1 

number  .of.  damage_filcs 

check_for_nonexistant_damage_filcs() 
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2.6.11.1.1  inap_get_daniage_files 

This  loudne  reads  in  damage  files.  The  damage  file  name  is  checked  to  see  if  it  is 
recognized  as  one  that  has  already  been  read  in.  If  the  file  has  been  read  previously,  the 
index  is  made  to  point  to  the  already  read  in  damage  file.  If  the  damage  file  hasn't  b^n 
read  in  yet,  then  it  is  read  in.  If  the  file  is  read  in  successfully,  the  index  is  made  to  point  to 
the  correct  damage  file.  If  the  damage  file  was  not  available,  ^is  entry  is  marked  so  it  can 
be  updated  to  point  to  the  default  damage  table. 


1  Internal  Variables  1 

Internal  Variable 

Where  Tvoedef  Declared 

j 

int 

Standard 

i 

int 

Standard 

number  of  damaae  files 

int 

Standard 

alreadsy  read  this  damage 
file 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

cfail  read  damage  file 

Section  2.5.4.5.2 

check_for_nonexistant_ 
damaae  files 

Section  2.6.11.1.2 

Table  2.6>161:  map_get_damage_files  Information. 


2.6.11.1.2  check_for_nonexistant_damage_files 

This  routine  checks  for  nonexistant  damage  files.  Default  entries  must  have  valid  damage 
tables.  If  the  damage  table  can  not  be  found  (not  on  disk)  for  a  given  entry,  then  the 
damage  file  index  is  made  to  be  the  same  as  the  default  entry.  Update  first Jn  ammo  class 
to  \xfirstjn_class  (i+1). 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

i 

int 

Standard 

first  in  ammo  class 

int 

Standard 

Table  2.6*162:  check_for_nonexistent_damage_fiIes  Information. 
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2.6.11.2  get  entry.c 

(7simnet^leas^src/libsrc/libmap/get_entTy.c) 

This  file  contains  routines  used  to  map  between  the  network  and  CIG. 

The  following  files  are  included: 

"stdio.h" 

"basic.h" 

"obj_type.h" 

"libmap_dfn.h" 

The  following  constants  are  defined: 

CALBER.SMALL 

CALIBER.MEDIUM 

The  following  are  declared  externally: 
ded_map_entries  [] 
last_in_ammo_class[] 
number_of_entries 
search_obj_types() 
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2.6.11.2.1 


inap_get_ammo_ent  ry  _f roin_network_ty  pe 


This  routine  maps  ammo  types  from  the  network  to  the  CIG.  The  ammunition  type  is 
represented  by  ammo  type. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ammo  tvoe 

ObiectType 

p  sim.h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

caliber 

int 

Standard 

1  Return  Values  1 

1  Return  Value 

Type 

iimnsmmmmm 

int 

missiles 

search  obLtypes(ammo 
tvoe.  MAP  PROJ  SMALL) 

int 

small  projectiles 

search  obLtypes(ammo 
tvoe.  MAP  PROJ  MEDIUM) 

int 

medium  projectiles 

search  obLtypes(ammo 
tvoe.  MAP  PROJ  LARGE) 

int 

large  projectiles 

search  obLlypes(ammo 
type.  MAP  BOMBS) 

int 

mines  are  treated  as  bombs 

-1 

int 

default 

1  Calls  1 

Function 

Where  Described 

search  obj  types 

Section  2.6.11.2.2 

Table  2.6-163:  map_get_ammo_entry_from_network_type  Information. 
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2.6.11.2.2  search_obj_types 

Given  an  object  type,  the  routine  searches  through  the  data  structure  and  returns  the  low 
integer  that  represents  that  object  type. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

last  in  ammo  class  index 

int 

Standard 

ammo  type 

ObiectTvoe 

p  sim.h 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

start  index 

int 

Standard 

end  index 

int 

Standard 

1 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

i 

int 

index  corresponding  to  object 
type 

end  index 

int 

iast  entry  in  table 

Table  2.6-164:  search_obj_types  Information. 


2.6.11.2.3  map_get_network__type_from_ammo_entry 


This  routine  converts  the  index  in  the  map  anay  into  a  network  munition,  ammojsntry  is 
the  entry  in  the  map  array  which  represents  a  particular  ammunition  type. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ammo  entry 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

obiectirrelevant 

ObiectType 

irrelevant  object 

ded_map_entries 
fammo  entry]  ->  ammunition 

ObjectType 

ammunition  type 

Table  2.6-165:  map_get_network_type_from_ammo_entry  Information. 
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2.6.11.2.4  map_get_burst_ground_froin_ammo_entry 


This  routine  returns  the  low  integer  that  represents  the  ground  burst  effect  for  a  particular 
ammunition  type.  ammo_entry  is  the  member  of  the  map  array  which  represents  a 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ammo  entry 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

dont_know 

unsigned  char 

don't  recognize  ammunition 
type 

ded_map_entries[ammo_ 
entry]  ->  burst  around 

unsigned  char 

ground  burst  effect  for  an 
ammunition  type 

Table  2.6*166:  map_get_burst_ground_from_ammo_entry  Information. 


2.6.11.2.5  map_get_burst_air_from_ammo_entry 


This  routine  returns  the  low  integer  that  represents  the  air  burst  effect  for  a  particular 
ammunition  type. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ammo  entry 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

dont_know 

unsigned  char 

don’  recognize  ammunition 
type 

ded_map_entries 
fammo  entry! ->  burst  air 

unsigned  char 

air  burst  effect  for  ammunition 
type 

Table  2.6-167:  map_get_burst_air_from_ammo_entry  Information. 
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2^46 .11.2.6  map_get_burst_armor_from_ammo_entry 

Tbiis  routine  returns  the  low  integer  that  represents  the  armor  burst  effect  for  a  particular 
aimmunition  type. 


1  Parameters  1 

Partameter 

Where  Tvpedef  Declared 

amiBX)  entry 

int 

Standard 

1  Return  Values  1 

Rec^n  Value 

Type 

Meanina 

don«_know 

unsigned  char 

don’t  recognize  ammunKion 
type 

de(£_map_entrjes 
farramo  entrvl ->  burst  armor 

unsigned  char 

armor  burst  effect  for 
ammunition  type 

Table  2.6-168;  map_get_burst_armor_from_ammo_entry  Information. 


2 . 6' .  1 1 . 2 . 7  map_get_burst_wood_from_ammo_entry 

Thus  routine  returns  the  low  integer  that  represents  the  wood  burst  effect  for  a  particular 
ammunition  type. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

amimo  entry 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

dors!‘i_know 

unsigned  char 

don’t  recognize  ammunition 
type 

ded_map_entries 
larrnmo  entry!  ->  burst  wood 

unsigned  char 

wood  burst  effect  for 
ammunition  type 

Table  2.6-169:  map_get_burst_wood_from_ammo_entry  Information. 
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2.6.11.2.8  ma  p_get_bu  rst_ot  he  r_t  r  :>m_ammo_en t  ry 

This  routine  returns  the  low  integer  that  represents  the  burst  effect  for  unknown  objects 
given  a  particular  type  of  ammunition. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

ammo  entrv 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

dont_know 

unsigned  char 

don1  recognize  ammunition 
type 

ded_map_entries 
lammo  entry]  ->  burst  other 

unsigned  char 

burst  effect  for  ammunition 
type 

Table  2.6-170:  map_get_burst_other_from_ammo_entry  Information. 


2.6.11.2.9  map_get_tracer_from_ammo_entry 


This  routine  returns  the  low  integer  that  represents  a  tracer  for  a  given  projectile. 


I  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

ammo  entry 

int 

Standard 

I  Return  Values  I 

Return  Value 

Meaning 

dont  know 

unsigned  char 

no  effect  should  be  shown 

ded_map_entries 
[ammo  entry] ->  tracer 

unsigned  char 

tracer  effect  based  on 
projectile  type 

Table  2.6-171:  map_get_tracer_from_ammo_entry  Information. 
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2.6.11.2.i«0 


iiiap_get_inu2zle_flash_me_froin_ammo_entry 


This  routme  nstunss  the  low  integer  that  represents  the  own  muzzle  flash  effect  for  a  given 
ammunition  pype.^ 


Parameter 


ammo  ent 


IEI73 


Parameters 


Where  Typedef  Declared 


Standard 


Return  Values 


Return  Valuw 


dont  know 


ded_map_entnes 
[ammo_entryI  -i> 
muzzle  flash  tme 


unsioned  char 


unsigned  char 


Meanin 


ammo  type  not  recoonized 


muzzle  flash  effect  for  a  given 
ammunition  type 


Table  2.6-172::  niap__get_muzzIe_fIash_me_from_ammo_entry  Information. 


2.6.11.2.11 


map_get_muzzIe_flash_other_from_ammo_entry 


This  routine  tfoe  low  integer  that  represents  the  muzzle  flash  effects  on  another  vehicle  given 
a  particular  aimmumtion  Qrpe. 


Parameters 


Parameter 


ammo  ent 


Where  Typedef  Declared 


Standard 


Return  Values 


Return  Valwe 


dont_know 


ded_map_enttries 
[ammo_entryE  -> 
muzzle  flash  other 


unsigned  char 


unsigned  char 


Meanin 


ammunition  type  not 
recoonized 


other  vehicle’s  muzzle  flash 
effect  for  ammunition  type 


Tabic  2.6^-173;  map_get  muzzle_flash_other_from_ammo_entry 

”  Information. 
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2.6.11.2.12 


map_get_dainage_file_index_froin_ainino_entry 


This  routine  returns  the  index  into  the  array  of  damage  tables  for  a  given  ammunition  type. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ammo  entry 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

-1 

int 

ammunition  type  is  not 
recoanized 

ded_map_entt1es 
Iammo_entry]  •> 
damaoe  file  index 

int 

index  into  damage  file  array 

Table  2.6-174:  map_get  damage  fiIe_index_from_ammo_entry 

Information.” 


2.6.11.2.13  map_get_ammo_class_from_ammo_en  t  ry 

This  routine  returns  the  class  of  ammunition  given  the  low  integer  that  represents  the 
ammunition  type. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ammo  entry 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

don’t  recognize  the 
ammunition  type 

MAP  BOMBS 

int 

the  class  is  bomb 

MAP  MISSILES 

int 

the  class  is  missile 

MAP  PROJ  SMALL 

int 

the  class  is  small  projectile 

MAP  PROJ  MEDIUM 

int 

the  class  is  medium  projectile 

MAP  PROJ  LARGE 

int 

the  class  is  large  projectile 

Table  2.6-175:  map_get_ammo_class_from_ammo_entry  Information. 
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Table  2.6-176:  map_is_boinb  Information. 


2.6.11.2.15  map_is_missile 

Given  a  list  of  items,  this  routine  returns  TRUE  if  an  item  is  a  missile  and  returns  FALSE 
otherwise. 


Parameter 


ammo  en 


IEI73 


Parameters 


Where  Typedef  Declared 


Standard 


Return  Values 


Return  Value 


(ammo_entry>lastjn  ammo_  int 
class  IMAP_B0MBS)T && 
(ammo_ertry<= 
last_in_ammo_class[MAP_MI 
SSILESl) 


Meanin 


TRUE  if  the  item  is  a  missile 
FALSE  if  the  item  isn’t  a 
missile 


Table  2.6-177:  map_is_missile  Information. 


I4M 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.6.11.2.16 


map_is_projectile 


Given  a  list  of  items,  this  routine  returns  TRUE  if  an  item  is  a  projectile  and  returns  FALSE 
otherwise. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

ammo  entry 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

(ammo  entry>last  in  ammo 

class  [MAP.MISSILES))  && 

(ammo_entry<= 

last  in  ammo  ciass[MAP  PR 

OJ  LARGEll 

unsigned  char 

TRUE  if  it  is  a  projectiie 

FALSE  if  it  is  not  a  projectile 

Table  2.6-178:  map_is_projectiIe  Information. 


2.6.11.3  niap_ammo.c 

(./simne^'rclease/src/libsrc/libmap/map_ammo.c) 

This  file  contains  the  routines  which  read  a  map  file  into  a  structure  of  the  format 
DED_MAP_ENTRY. 

The  following  are  included: 

"stdio.h" 

"signal.h" 

"ctype.h" 

"sim_types.h" 

"sim_dfns.h" 

sim_macros.h" 

"simstdio.h" 

"libmap_dfn.h" 

"libmap.h" 

The  following  are  declared  as  external: 

map_start_names[NUMBER_OF_MAP_CLASSES]  [30] 
map_end_names[NUMBER_OF_MAP_CLASSES]  [30] 
ded_map_entries  [MAX_DED_ENTRIES] 
callocO 

skip_coniment() 

read~entry_attributes() 

read”char(r 

readJong_int() 

get_entries_until_end_subclass() 

print_structure_contents() 

checir_for_defaults() 

Iast_in_ammo_class  [NUMBER_OF_MAP_CLASSES] 

number_of_entries 

map_file 
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2Z.6.11.3.1  map_file_read 

'UTiis  routine  reads  the  file  specified  by  the  argument^te  /iamc. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

name 

pointer  to  char 

Standard 

t  Internal  Variables  1 

internal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

ttemo  str  1801 

char 

Standard 

1  Calls  1 

Function 

Where  Described 

s^kip  comment 

Section  2.6.11.3.3 

gjet_enlries_untiLend_subcla 

ss 

Section  2.6.11.3.6 

dheck  for  defaults 

Section  2.6.11.3.7 

pnint  structure  contents 

Section  2.6.11.3.8 

Table  2.6-179:  map_file_read  Information. 


:2.6.11.3.2  read_entry_attributes 

'This  routine  reads  the  attributes  of  the  entries  in  the  table. 


I  Internal  Variables  1 

hnternal  Variable 

Type 

Where  Typedef  Declared 

tremp  str  1801 

char 

Standard 

ittemp 

int 

Standard 

Calls 

Function 

Where  Described 

iread  char 

Section  2.6.11.3.4 

read  Iona  int 

Section  2.6.11.3.5 

Table  2.6-180:  read_entry_attributes  Information. 
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2.6.11.3.3 


skip_comment 


If  a  #  is  found  at  the  beginning  of  a  line,  the  line  is  skipped  by  searching  for  a  caniage 
return. 


1  Internal  Variables  1 

Internal  Variable 

Where  Tvoedef  Declared 

character 

int 

Standard 

Table  2.6-181:  skip^comment  Information. 

2.6.11.3.4  read_char 

This  routine  reads  in  a  character  string  and  compares  it  to  a  known  string.  If  they  match, 
the  routine  reads  in  a  string  and  pu.s  it  in  the  structure. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

compare  strina 

pointer  to  char 

Standard 

current  entry 

int 

Standard 

data  entry 

unsianed  pointer  to  char 

Standard 

1  Internal  Variables  1 

1  Internal  Variable  1 

Where  Typedef  Declared 

II  liil  Hill  M—— 

char 

Standard 

hemp  int 

int 

Standard 

Table  2.6-182:  read_char  Information. 


2.6.11.3.5  read_Iong_int 

This  routine  reads  in  a  string  and  compares  it  to  a  known  string.  If  they  match,  the  routine 
reads  in  a  long  integer  and  puts  it  in  the  structure. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

compare  strina 

pointer  to  char 

Standard 

current  entry 

int 

Standard 

pointer  to  int 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

temp  strfSOI 

char 

Standard 

Table  2.6-183:  readJong_int  Information. 
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2.6.11.3.6  get_entries_until_end_subclass 


This  routine  reads  in  the  entries  of  one  particular  class  at  a  time.  The  subclass  is  designated 
by  subclass  jam. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

subclass  num 

int 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

temp  str  1301 

char 

Standard 

1  Calls  1 

Function 

Where  Described 

skip  comment 

Section  2.6.11.3.3 

read  entry  attributes 

Section  2.6.11.3.2 

Table  2.6-184:  get_entries_until_end_subclass  Information. 


2.6.11.3.7  check_for_defaults 

This  function  checks  for  defaults. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.6-185:  check_for_defaults  Information. 


2.6.11.3.8  print_structure_contents 

This  function  is  stubbed  out  but  provides  no  functionality. 
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2.6.11.4  map_asid.c 

(7simnetAelease/src/libsrc/libmap/map_asid.c) 

This  file  contains  routines  which  are  used  to  map  between  bits  set  in  the  appearance  field  of 

the  VehicleAppearanceVariant  to  the  cig  ASID  designators 

The  following  are  included: 

"stdio.h" 

"ctype.h" 

"pro_sim.h" 

"veh_type.h" 

"veh_appear.h" 

simstdio.h" 

The  following  are  declared  as  external: 
dust_cloud_shift 
dust_cloud_mask 
dust_cloud_none 
dust_cloud_small 
dust_cloud_medium 
dust_cloud_large 
smoke_shift 
flames_shift 

tow_launcher_down_shift 

tow_launcher_up_shift 

engine_smoke_shift 

bumpcr_mask 

bumper_shift[3] 

asid 

bumper_status 

asid_debug 

2.6.11.4.1  map_read_asid_file 

This  routine  reads  an  ASID  mapping  file  designated  by  the  argument 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fn 

pointer  to  char 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

fp 

pointer  to  FILE 

Standard 

$1801 

char 

Standard 

Table  2.6-186:  map_read_asid_nie  Information. 
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2.6.11.4.2  map_set_asid 


This  routine  sets  specific  bits  and  values  for  the  ASID 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

value 

unsigned  long 

Standard 

clear  mask 

unsigned  long 

Standard 

Table  2.6>187:  map_set_asid  Information. 


2.6.11.4.3  map_clear_asid 

This  routine  clears  a  specific  bit  for  the  ASDD. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

value 

unsigned  long 

Standard 

Table  2.6-188:  map_clear_asid  Information. 


2.6.11.4.4  map_set_bumper_numbers 

This  routine  sets  bits  for  vehicle  bumper  numbers,  marking  represents  the  bumper  number 
to  be  set. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared  I 

marking 

pointer  to  VehicleMarking 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

i 

register  int 

Standard 

chI2] 

char 

Standard 

1  Calls  1 

Function 

Where  Described 

map  set  asid 

Section  2.6.11.4.2 

Table  2.6-189:  map_set_bumper_numbers  Information. 
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2.6.11.4.5  map_set_dust_cIoud 
This  routine  sets  the  dust  cloud  bits. 


1  Parameters  1 

Parameter 

Type 

Where  Tvoedef  Declared 

cloud 

ini 

Standard 

Calls 

Function 

Where  Described 

map  set  asid 

Section  2.6.11.4.2 

Table  2.6-190:  inap_set_dust_cloud  Information. 


2.6.11.4.6  map_get_bumper_status 


This  routine  indicates  whether  or  not  bumper  numbers  are  to  be  displayed. 


I  Return  Values  I 

Return  Value 

Type 

Meanlnp 

bumper_slatus 

static  int 

whether  or  not  bumper 
numbers  are  to  be  displayed 

Table  2.6-191:  map_get_bumper_status  Information. 
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2.6.11.4.7  map_format_asid 

This  routine  maps  the  ASID.  This  is  the  main  routine  in  this  module. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

pointer  to 

VehicleAppearanceVariant 

1  Internal  Variables  1 

1  Internal  Variable  1 

Where  Typedef  Declared 

reaister  unsianed  Iona 

Standard 

Iveh  type 

ObiectType 

p  sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

asid 

unsigned  long 

a  properly  formatted  bit 
field(ASID)  which  tells  the  cig 
which  effect  to  paint 

1  Calls  1 

Function 

Where  Described 

veh  aet  force 

Section  2.6.10.6.3 

mao  set  asid 

Section  2.6.11.4.2 

Section  2.6.11.4.3 

mao  set  dust  cloud 

Section  2.6.11.4.5 

mao  oet  bumoer  status 

Section  2.6.11.4.6 

ia  friendly 

Section  2.6.10.6.1 

map  set  bumper  numbers 

Section  2.6.11.4.4 

Table  2.6-192:  map_format_asid  Information. 


2.6.11.4.8  map_set_bumper_status 
This  routine  sets  the  bits  for  bumper  status. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

state 

int 

Standard 

Table  2.6-193  map_set_bumper_status  Information. 
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2.6.11.5  inap_veh.c 

(ysimnet^lease/src/libsrc/libniap/map_veh.c) 

This  file  contains  the  routines  that  read  a  vehicle  map  file  into  a  structure  of  the  format 
DEp_VEH_ENTRY.  This  file  was  modified  from  Tead_map.c  for  atiuno  entries.  The 
vehicle  type  is  broken  down  into  environments  which  are  in  turn  broken  down  into  classes. 


The  following  files  are  included: 

"stdio.h" 

"signal. h" 

"ctype.h" 

"simstdio.h" 

"sim_types.h" 

"sim_dtfns.h" 

"sim_macros.h" 

"obj_types.h" 

"veh_appear.h" 

"basic.h" 

"libmap_dfn.h" 

"libmap.h" 

The  structure  DED_VEH_ENTRY  is  defined. 

The  following  constants  are  defined: 
MAX_VEH_MAP_CLASSES 
MAX_NUM_DED_INDICIES 
NUM.DEFAULTS 
MAP_AIR_FIXED_WING 
MAP_AIR_LIGHTER_THAN_AIR 
MAP_AIR_ROTARY_WING 
MAP_GROUND_SP_ARMORED_TRACKED 
MAP_GROUND_SP_ARMORED_WHEELED 
MAP_GROUND_SP_UNARMORED_TRACKED 
MAP_GROlJND_SP_UNARMORED_WHEELED 
MAP_GROUND_TOWED 
MAP  SPACE 

mapIwater_amphib_warfare 

MAP_WATER_AUXILIARY 

MAP_WATER_MATERIAL_SUPPORT 

MAP_WATER_MINE_WARFVARE 

MAP_WATER_SUBMARINE 

jap_water_surface_combat 

JMAP_MUNmON 

MAP.STRUCTURE 

MAP_LIFEFORM 
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The  following  are  declared  as  external: 
veh_map_debug 

veh_start_names[MAX_VEH_MAP_CLASSES]  [40] 
veh_end_naines[MAX_VEH_MAP_CLASSES]  [40] 
start_veh_pt  [MAX_VEH_MAP_CLASSES] 
end_veh_pt  [MAX_VEH_MAP_CLASSES] 
ded_veh_entries  [MAX_NUM_VEH_ENTRffiS] 
ded_cig_veh_ptrs  [MAX_NUM_DED_INDICES] 
callocO 

skip_veh  commentO 

read”vehTcle_eiitry_attributes() 

read~char_vehicle  entryO 

read~long~int_vehicle_entry() 

get_vehicle_entries_until_end_subclass() 

pnnt_vehicle_attrit)ute_cohtents() 

checir_for_ve*hicle_def^uIts() 

entrieslperjclass  [MAX_VEH_MAP_CLASSES] 

number_of_entries 

map_file 

2.6.11.5.1  inap_vehicle_file_read 

This  routine  reads  a  vehicle  mapping  file  designated  by  the  argument  file  name. 


Parameter 

file  name 


_ Parameters _ _ 

Type  [Where  Tvpedef  Declared 

pointer  to  char_ Standard 


1  Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

temp  str  1801 

char 

Standard 

done 

int 

Standard 

Calls 


Function 


Where  Described 


skip  veh  comment 


Section  2.6.1 1.5.2 


get_vehicle_entries_u  ntil_en 
d  subclass 


Section  2.6.11.5.5 


check  for  vehicle  defaults 


Section  2.6.11.5.26 


Table  2.6-194;  map_vehicle_file_read  Information. 
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2.6.11.5.2 


read_vehicle_entry_attributes 


This  routine  reads  the  attributes  of  the  entries  in  the  table.  If  the  entry  is  ok,  cig_yeh  jype 
is  made  to  be  an  integer,  ded  cig  veh  j)trsltempJ  then  points  to  the  entry  that  was  just 
added.  This  allows  for  rapid  mapping  of  a  cig_yeh  jype  to  an  object  type  for  the  network. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

temo  strfSOI 

char 

Standard 

temp 

int 

Standard 

Calls 

Function 

Where  Described 

read  Iona  int  vehicle  entry 

Section  2.6.11.5.5 

read  char  vehicle  entry 

Section  2.6.11.5.4 

Table  2.6*195:  read_vehicle_entry_attributes  Information. 


2.6.11.5.3  skip_veh_comment 

If  a  #  at  the  beginning  of  a  line  has  been  found,  this  line  is  ignored  because  it  is  a  comment 
line. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

character 

int 

Standard 

Table  2.6*196:  skip_veh_comment  Information. 


2.6.11.5.4  read_char_vehicle_entry 

This  routine  reads  in  a  character  string  and  compares  it  to  a  known  string.  If  they  match, 
the  routine  reads  in  a  string  and  puts  it  in  the  structure. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

compare  strina 

pointer  to  char 

Standard 

curret  entry 

int 

Standard 

data  entry 

unsigned  pointer  to  char 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

temp  strlSOl 

char 

Standard 

temp  int 

int 

Standard 

Table  2.6*197:  read_char_veh_entry  Information. 
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2.6.11.5.5  read_long_int_vehicIe_entry 

This  routine  reads  a  string  and  compares  it  to  a  known  string.  If  they  match,  the  routine 
reads  in  a  long  integer  and  puts  it  in  the  structure. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

compare  strina 

pointer  to  char 

Standard 

current  entry 

int 

Standard 

data  entry 

pointer  to  int 

Standard 

Internal  Variables 


Internal  Variable 

Type 

Where  Typedef  Declared 

temp  sttfSOI 

char 

Standard 

Table  2.6-198:  read_long_int_veh_entry  Information. 


2.6.11.5.6  get_vehicle_entries_until_end_subclass 


This  routine  reads  in  the  endies  of  a  particular  vehicle  class  at  a  time.  The  vehicle  subclass 
is  designated  by  subclass  jium. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

subclass  num 

int 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

temp  strfSOli 

char 

Standard 

1  Calls  1 

Function 

Where  Described 

skip  yeh  comment 

Section  2.6.11.5.3 

read  yehicle  entry  attributes 

Section  2.6.11.5.2 

Table  2.6-199  get_vehicle_entries_until_end_subclass  Information. 


2.6.11.5.7  check  for  vehicle  defaults 


This  routine  checks  for  vehicle  entry  defaults.  If  the  vehicle  code  doesn't  exist,  a  default 
code  will  be  assigned. 


1  internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.6-200:  check_for_vehicle_defaults  Information. 
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2.6.11.5.8  map_net_to_cig 


This  routine  takes  the  network  type  and  returns  the  CIG  type  for  various  models.  The 
network  type  is  specified  by  object  type  and  appearance. 


1  Parameters  1 

1  Parameter 

Where  Typedef  Declared 

1  object  type 

ObjectType 

II  . . . 

unsianed  Iona 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

check  for  matchO 

unsianed  char 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

check  for  match 
(MAP_MUNITlON, 
object  type,  appearance) 

int 

CIG  model  for  a  giyen  munition 

check  for  match 
(MAP_STRUCTURE, 
object  type,  appearance) 

int 

CIG  model  for  a  building 

check  for  match 
{MAP_LIFEFORM, 
object  type,  appearance) 

int 

CIG  model  for  a  lifeform 

check  for  match 
(MAP_AIR_FIXED_WING, 
object  type,  appearance) 

int 

CIG  model  for  a  fixed  wing 
aircraft 

check  for  match 
(MAP_AIR_LIGHTER_THAN_ 
AIR,  Object  type,  appearance) 

int 

CIG  nxxJel  for  any  aircraft 
which  is  not  a  fused  wing  or 
rotary  wing 

check  for  match(MAP  AIR 
ROTARY_WING.  objectjype, 
appearance) 

int 

CIG  model  for  a  rotary  wing 
aircraft 

check  for  match 
(MAP  GROUND  SP  ARMO 
RED_TRACKED, 
object  type,  appearance) 

int 

CIG  model  for  an  armored 
tracked  ground  vehicle 

check  for  match 
(MAP  GROUND  SP  ARMO 
RED_WHEELED, 
object  type,  appearance) 

int 

CIG  model  for  an  armored 
wheeled  ground  vehicle 

check  for  match 
(MAP  GROUND  SP  UNARM 
ORED_TRACKED. 
object  type,  appearance) 

int 

CIG  model  for  an  unarmored 
tracked  ground  vehicle 

check  for  match 
(MAP  GROUND  SP  UNARM 
ORED_WHEELED. 
object  type,  appearance) 

int 

CIG  model  for  an  unarmored 
wheeled  ground  vehicle 

check  for  match 
(MAP_GROUND_TOWED, 
object  type,  appearance) 

int 

CIG  model  for  a  towed  ground 
vehicle 
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1  Return  Values  (cont.)  I 

Return  Value 

Meanina 

check  for  match 
(MAP_WATER_AMPHIB_WA 
RFARE,  objectjype, 
aoDearance) 

int 

CIG  model  for  amphibious 
vehicle 

check  tor  match 
(MAP_WATER_AUXILIARY. 
object  tvoe.  appearance) 

int 

CIG  nxxlel  for  a  sea  auxiliary 
vessel 

check  for  match 
(MAP_WATER_MATERIAL_S 
UPPORT,  objectjype, 
appearance) 

int 

CIG  model  for  sea  supply 
vessel 

check  for  match 
(MAP_WATER_MINE_WARF 
ARE,  Objectjype, 
appearance) 

int 

CIG  nxxlel  for  a  sea  mine 
sweeper 

check  for  match 
(MAP_WATER_SUBMARINE, 
object  type,  appearance) 

tint 

CIG  model  for  a  submarine 

check  for  match 
(MAP_WATER_SURFACE_C 
OMBAT,  objectjype, 
appearance) 

int 

CIG  nx>del  for  a  surface  sea 
vessel 

checkJor_match 
(MAP_SPACE,  objectjype, 
appearance) 

int 

CIG  model  for  a  space  craft 

1  Calls  1 

Function 

Where  Described 

check  for  match 

Section  2.6.11.5.9 

Table  2.6-201:  map_net_to_cig  Information. 
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2.6.11.5.9 


check  for  match 


This  routine  checks  to  see  if  the  network  type  exists  in  the  structure.  If  it  doesn’t,  a  default 
is  chosen. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

subclass 

int 

Standard 

ObieclTve 

p  sim.h 

unslaned  Iona 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

i 

reqister  int 

Standard 

tmpP 

pointer  to  a  pointer  to 

DED  VEH  ENTRY 

libmapjdfn.h 

1  Return  Values  1 

Return  Value 

Type 

Meanlnp 

(*tmDP)->destroved  tvoe 

unsianed  char 

destroyed  model 

l*tmDP)->cia  veh  tvoe 

unsianed  char 

healthy  model 

Table  2.6*202:  check_for_match  Information. 
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2.6.12  libmem 

(7simnet/release/src/libsrc/libmem  [libmem]) 

Libmem  provides  a  machine  independent  mechanism  for  establishing  a  lo^cal  shared 
memory  segment  in  which  control  values  are  stored  by  the  IDC  device  driver  and  from 
which  diey  can  be  received  by  the  simulation  host 


2.6.12.1  assign_mp.c 

(ysimnet/release/src/libsrc/libmem/assign_mp.c) 

This  file  contains  routines  which  are  called  during  initialization  to  set  up  the  shared  memory 

segment 

The  following  are  included; 

"stdio.h" 

"fcntl.h" 

"sys/types.h" 

"sys/ipc.h" 

"sys/pte.h" 

"sys/shm.h" 

"sim_dfns.h" 

"fifo_dfn.h" 

"libmem_dfn.h" 

’’Ubmem.h" 

The  following  are  defined: 

IDCSHM_NAME  (Butterfly  only) 

The  following  external  variables  are  declared: 
idc_values 
cp 

idc_yalues  is  a  pointer  to  mapped  memory. 
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% 


2.6.12.1.1  mem_assign_memory_ptr 

This  routine  is  called  at  initialization  to  assign  a  pointer  to  the  start  address  of  the  idc 
values. 

If  a  Butterfly  is  used: 


1  Calls  1 

Function 

Where  Described 

map  Idc  values 

Section  2.6.12.1  .3 

Table  2.6>203:  mem_assign_memory_ptr  Information  for  the  Butterfly. 
If  a  Masscomp  is  used; 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

id 

int 

Standard 

Id 

int 

Standard 

sbrkO 

pointer  to  char 

Standard 

shmatO 

pointer  to  char 

Standard 

size 

int 

Standard 

Table  2.6*204:  niem_assigned_memory_ptr  Information. 


2.6.12.1.2  mem_free_sha red_memory 

This  routine  frees  the  shared  memory  segment. 
If  a  Butterfly  is  used: 


1  Calls  1 

Function 

Where  Described 

unmap  idc  values 

Section  2.6.12.1.4 

Table  2.6-205:  mem_free_shared_memory  Information  for  the  Butterfly. 
If  a  Masscomp  is  used  no  functions  are  called. 
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2.6.12.1.3  inap_idc_values 


This  routine  maps  the  idc  values  to  shared  memory.  This  routine  is  only  defined  for  the 
Butterfly. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

idc  values  01 D 

OID 

**** 

Table  2.6>206:  map_idc_values  Information. 


2.6.12.1.4  unmap_idc_values 


This  routine  unmaps  the  idc  values  from  shared  memory.  This  routine  is  only  defined  for 
the  Butterfly. 


1  Internal  Variables  1 

Internal  Variable 

Where  Tvoedef  Declared 

idc  values  OID 

OID 

**** 

Table  2.6-207:  unmap_idc_values  Information. 


2.6.12.1.5  mem_get_idc_share__size 

This  routine  returns  the  size  of  the  BDC  shared  memory. 


1  Return  Values  1 

Return  Value 

Meaning 

IDC  SHARE  SIZE 

int 

IDC  shared  memory  size 

Table  2.6-208;  mem_get_idc_share_size  Information. 


2.6.12.1.6  mem_get_memory_key 
This  routine  returns  the  memory  key. 


Return  values 


Return  Value 

Type 

Meaning 

MEMORY  KEY 

int 

memory  key 

Table  2.6-209;  mem_get_memory_key  Information. 
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2.6.12.1.7 


mein_get_total_share_size 


This  routine  returns  the  size  of  the  entire  block  of  shared  memory,  which  consists  of  the 
IDC  segment  and  the  FIFO  segment. 


1  Return  values  I 

Return  Value 

Type 

TOTAL  SHARE  SIZE 

int 

total  shared  memory  size  I 

Table  2.6-210:  mem_get_total_share_si2e  Information. 

2.6.12.2  assign  sm.c 

(./simnel/release/src/libsrc/libmem/addign_sm.c) 

This  file  contains  a  routine  which  assigns  the  shared  memory  segment  at  the  startup  of  the 
simulation. 

"libmem.h"  is  included. 


2.6.12.2.1  mem_assign_shared_memory 

This  routine  assigns  the  shared  memory  pointers  used  with  the  IDC’s. 


1  Calls  1 

Function 

Where  Described 

mem  assian  memory  otr 

Section  2.6.12.1.1 

mem_assign_other  jatrs 

Section  2.6.13.1  for  the  Ml 

Section  2.6.14.1  for  the  M2 

Section  2.6.15.1  for  the  Stealth 

Table  2.6-211:  mem_assign_shared_memory  Information. 
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2.6.13  inl_inem.c 

(/simnetAelease/src/vehicle/ml/src/ml_mem.c  [ml_mem.c]) 

Vehicle-specific  routines  are  called  in  ml_mem.c  to  assign  portions  of  the  shared  memory 
segment  to  individual  idc  ports,  once  the  shared  memory  segment  has  been  established. 

Includes; 

"stdio.h" 

"sim_dfns.h" 

"fifo_dfn.h" 

"libmem_dfn.h" 

"ml_mem_dfn.h" 

Declared  as  pointers  to  FIFO; 
fifo_driver 
fifo_tunet 
fifo_ammo 
dummy  1 
dummy2 
sounds 
dummyS 
dummy4 

Declared  as  pointer  to  short: 
pser_heartbeat 

fifo_driver  is  a  pointer  to  the  driver  output  queue,  fifojurret  is  a  pointer  to  the  turret 
output  queue.  fifo_ammo  is  a  pointer  to  the  ammo  output  queue,  dummy  1  is  a  pointer  to 
the  dummyl  output  queue.  dummy2  is  a  pointer  to  the  dummy2  output  queue,  sounds  is  a 
pointer  to  the  sounds  output  queue.  dummyS  is  a  pointer  to  the  dummy3  output  queue. 
dummy4  is  a  pointer  to  the  dutnmy4  output  queue,  pser  heartbeat  is  a  pointer  to  the 
HPSM  heartteat. 


2.6.13.1  mem_assign_other_ptrs 

This  routine  assigns  additional  pointers  to  the  shared  memoiy'  segment  for  use  in  the  M 1 
simulation. 
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2.6.14  ni2_mem.c 

(/simnel/release '  ./vehicle/m2/src/m2_mem.c  [m2_mem.c]) 

Vehicle-specific  routines  are  called  in  ni2_mem.c  to  assign  portions  of  the  shared  memory 
segment  to  individual  idc  ports,  once  the  shared  memory  segment  has  been  established. 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"fifo_dfn.h" 

"libmem_dfn.h" 

"m2_mem_dfn.h" 

Declared  as  pointers  to  FIFO: 
fifo_driver 
fifo_turret 
dummy  1 
dummy2 
sounds 
dummyS 
dummy4 
alpha 

Declared  as  pointer  to  short: 
pser_heartbeat 

fifojdriver  is  a  pointer  to  the  driver  output  queue,  fifojurret  is  a  pointer  to  the  turret 
output  queue,  dummy  1  is  a  pointer  to  the  dummy  1  output  queue,  dummy!  is  a  pointer  to 
the  dummy2  output  queue,  sounds  is  a  pointer  to  the  sounds  output  queue.  dummyS  is  a 
pointer  to  the  drmmy3  output  queue.  dummy4  is  a  pointer  to  the  dummy4  output  queue. 
alpha  is  a  pointer  to  the  alpha  output  queue,  pser  heartbeat  is  a  pointer  to  the  HPSM 
heanbeat 


2.6.14.1  mem_assign_other_ptrs 

This  routine  assigns  additional  pointers  to  the  shared  memory  segment  for  use  in  the  M2 
simulation. 
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2.6.15  kato  mem.c 

(/simnet^lease/src/vehicle/kato/sTc/m2_mem.c  [kato_mem.c]) 

Vehicle-specific  routines  are  called  in  kato_mem.c  to  assign  portions  of  the  shared  memory 
segment  to  individual  idc  ports,  once  the  shared  memory  segment  has  been  established. 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"fifo.dfn.h" 

'’libmem_dfn.h" 

"kato_mem_dfn.h" 

Declared  as  pointers  to  FIFO; 
fifo_soft 
fifo_hard 
dummyO 
dummy  1 
dummy2 
sounds 
dummyS 
dummy4 

Declared  as  pointer  to  short: 
pser_heartbeat 

fifo_soft  is  a  pointer  to  the  soft  panel  output  queue,  fifojiard  is  a  pointer  to  the  hard  panel 
output  queue.  dummyO  is  a  pointer  to  the  dummyO  output  queue,  dummy  1  is  a  pointer  to 
the  dummy  1  output  queue,  dummy!  is  a  pointer  to  the  dummy2  output  queue,  sounds  is  a 
pointer  to  the  sounds  output  queue.  dummyS  is  a  pointer  to  the  dummy3  output  queue. 
dummy4  is  a  pointer  to  the  dummy4  output  queue,  pserjieartbeat  is  a  pointer  to  the 
HPSM  heartbeat. 


2.6.15.1  mem_assign_other_ptrs 

This  routine  assigns  additional  pointers  to  the  shared  memory  segment  for  use  by  the 
Stealth. 
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2.6.16  librtc 

This  CSU  contains  a  number  of  routines  which  are  used  to  time  segments  of  code  This 
library  can  be  used  as  a  debugging  feature. 

2.6.16.1  rtc  timing.c 

(ysimnet^lease/src/libsrc/librtc/rtc_timing.c) 

This  file  contains  routines  which  initialize  a  timing  event,  stop  a  timing  event,  It  also 
contains  routines  which  can  be  used  to  determine  the  length  of  time  spent  in  a  segment  of 
code.  Furthermore,  routines  are  included  which  can  be  used  for  printing  timing 
information  in  specific  formats. 

Includes: 

"net/network.h" 

"bbdjoc.h" 

"rtc.h" 


Ocfincs* 

NUMBER_IN_AVERAGE 

TICK.RATE 

External  Variables: 

rtc_bit_start[NUM_RTC_BITS] 

rtc_values  [NUM_RTC_BITS]  [NUMBER_IN_AVERAGE] 

currentjimerjndex  [NUM_RTC_BITS] 

rtc_bit_start[NUM_RTC_BITS]  is  the  value  of  the  timing  bit  at  the  start  of  the  timing  interval. 

rtc_valu0S  [NUM_RTC_BITS]  is  the  list  of  timing  intervals  for  each  timing  bit. 

If  the  simulation  is  running  on  a  Masscomp,  the  following  routines  are  smbbed  out. 
rtc_start_time() 
rtc”stopJt>*ne() 
rtc”time_history() 
rtc_print_time() 
rtc_print  overrun() 
rtc_printT() 
rtc_overrun() 
rtc_print_permanent() 
rtc_simuI_history() 
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2.6.16.1.1  rtc_read_clock 

This  routine  returns  the  number  ofTICK  RATE  ticks  since  the  timer  was  started. 


\  Return  values  1 

Return  Value 

Type 

Meanina 

rtc 

int 

ticks  elapsed  since  timer 
started  for  Butterfly  machine 

net_current_time 

(AssocGetNetHandleO) 

int 

ticks  elapsed  since  timer 
started  for  Masscomp  machine 

0 

int 

unknown  system 

Calls 

Function 

Where  Described 

net  current  time 

Section  2.20.2.8.3  in  MCC  CSCI 

AssocGetNetHandle 

Section  “**  MCC  CSCI  SDD 

Table  2.6-212:  rtc  read  clock  Information. 


2.6.16.1.2  rtc_start_tlme 

This  routine  is  called  to  mark  the  beginning  of  a  timing  interval,  bitnwn  is  the  number  of 
the  timing  bit. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

bitnum 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

rtc  read  clock 

Section  2.6.16.1.1 

Table  2.6-213:  rtc  start  time  Information. 
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2.6.16.1.3 


rtc_stop_time 


This  routine  is  called  to  end  a  timing  interval.  The  value  of  the  expired  time  is  saved. 
bitnum  is  the  number  of  the  timing  bit. 


1  Parameters  1 

■  Parameter 

Where  Tvpedef  Declared  I 

1  bitnum 

int 

Standard  ^  1 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

current  clock 

reoister  Iona 

Standard 

elapsed  ticks 

reoister  lonq 

Standard 

1  Calls  1 

Function 

Where  Described 

rtc  read  clock 

Section  2.6.16.1.1 

Table  2.6-214:  rtc_stop_time  Information. 


2.6.16.1.4  rtc_time_history 

This  routine  prints  the  actual  time  spent  each  tick  in  the  selected  code.  It  prints  out  all  of  the 
saved  entries  for  the  given  bit  number,  bitnum  is  the  number  of  the  timing  bit,  and 
temp  str  is  a  string  that  will  be  printed  before  the  time  history.  It  is  used  to  identify  what  is 
being  printed. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

temp  str 

pointer  to  char 

Standard 

bitnum 

int 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

i 

register  int 

Standard 

rtc  temp  time 

register  float 

Standard 

Table  2.6-215:  rtc_tinie_history  Information. 
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2.6.16.1.5  rtc_print_time 

This  routine  prints  out  the  maximum,  minimum,  and  average  amount  of  time  spent  in  the 
selected  segment  of  code.  The  average  is  taken  over  all  saved  entries  for  the  given  bit 
number. 

bitnum  is  the  number  of  the  timing  bit,  and  temp  str  is  a  string  that  will  be  printed  before 
the  time  history.  It  is  used  to  identify  what  is  being  printed. 

sumofjimes  is  the  number  of  TICK  RATE  ticks  in  the  total  timing  interval,  minticks  is 
the  number  of  TICK  RATE  ticks  in  the  smallest  timing  interval,  max  ticks  is  the  number 
of  TICK  RATE  ticks  in  the  largest  timing  interval,  avg  time  is  the  average  time  spent  in 
the  subroutine  in  milliseconds,  min  time  is  the  smallest  time  spent  in  the  subroutine  in 
milliseconds,  maxjime  is  the  largest  amount  of  time  spent  in  Ae  segment  of  code  in 
milliseconds. 

The  variables  that  compute  the  minimum,  maximum,  and  average  are  initialized.  The  sum 
of  the  numbers  to  be  averaged  is  found  as  well  as  the  minimum  and  maximum  timing 
inteervals.  The  average  timing  interval  is  then  computed,  ticks  are  converted  to 
milliseconds,  and  the  results  are  printed. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

bitnum 

int 

Standard 

temp  str 

pointer  to  char 

Standard 

1  Interna)  variables  1 

Internal  Variable 

Where  Typedef  Declared 

sum  of  times 

register  long 

Standard 

min  ticks 

register  long 

Standard 

max  ticks 

register  long 

Standard 

ava  time 

register  float 

Standard 

min  time 

register  float 

Standard 

max  time 

register  float 

Standard 

i 

register  int 

Standard 

Table  2.6-216:  rtc_print_time  Information. 


2.6.19.1.6  rtc_simuI_history 

A  list  of  10  segments  of  code  have  been  declared  always  important.  This  routine  prims  all 
50  saved  measurements  of  the  amount  of  time  spent  in  the  above  10  code  segments. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

i 

int 

Standard 

rtc  temp  time 

float 

Standard 

Table  2.6-217:  rtc_simul_histor>  Information. 
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2.6.16.1.7  rtc_print_overrun 

This  routine  prints  the  amount  of  time  spent  in  any  segment  of  code  in  which  an  overrun 
has  occurred. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

over  run  otr 

int 

Standard 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

rtc  overrun 

Section  2.6.16.1.9 

Table  2.6-218:  rtc_prInt_overrun  Information. 


2.6.16.1.8  rtc_printl 

This  routine  is  not  used. 

2.6.16.1.9  rtc  overrun 


This  routine  finds  the  largest  timing  interval  in  the  array  of  measurements  and  returns  the 
index  to  this  entry. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

lonqest  tick 

int 

Standard 

lonaest  time 

Iona 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

longestjick 

int 

pointer  to  longest  timing 
interval 

Table  2.6-219:  rtc  overrun  Information. 


2.6.16.1.10  rtc_print_permanent 


This  routine  prints  out  the  amount  of  time  spent  in  important  segments  of  code. 


1  Calls  1 

Function 

Where  Described 

rtc  print  time 

Section  2.6.16.1.5 

Table  2.6-220:  rtc_print_permanent  Information. 
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2.6.16.1.11  rtc_get_tick_rate 

This  routine  returns  the  tick  rate  for  the  real  time  clock  on  this  machine. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

TICK_RATE 

float 

the  tick  rate  for  the  rtc  on  this 
machine 

Table  2.6-221:  rtc_get_tick_rate  Information. 


2.6.16.1.12  rtc_get_start 

This  routine  returns  the  start  time  of  the  specified  timer,  bitnum  is  the  bit  number  of  the 
specified  timer. 


1  Parameters  I 

Parameter 

Where  Typedet  Declared 

bitnum 

int 

Standard 

1  Return  Values  I 

Return  Value 

Type 

rtc_bit_start[bitnum] 

long 

the  start  time  of  the  specified 
timer 

Table  2.6-222:  rtc_get_start  Information. 


2.6.16.2  rtc.h 

(./simnet/release/src/libsrc/librtc/rtc.h) 

This  file  contains  the  defines  for  all  timers  used  in  the  rtc  functions. 


2.6.17  libfile 

(/simnetAelease/src/libsrc/libfile  [libfile]) 

This  library  provides  a  package  of  UNIX  compatibility  functions  that  don’t  exist  on  the 
Butterfly.  Most  of  the  functions  are  related  to  file  access.  These  functions  do  exist  on 
most  UNIX  systems.  This  code  was  written  for  partability. 
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2.6.18  libquat 

Libquat  performs  equation  of  motion  operations  using  the  quaternions  or  Euler  parameters 
method.  Given  accelerations  and  velocities,  this  library  calculates  the  vehicle's  dynamic 
equations. 


2.6.18.1  calc_origin.c 

Includes; 

"sim_types.h" 

"sim_^ns.h" 


Declarations; 

view_point 


2.6.18.1.1  kinematics_viewpoint_offset 


This  routine  sets  the  viewpoint  offset  to  the  value  passed  in  v. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

v 

VECTOR 

/simnet/common/include/glob 
al/sim  types, h 

Table  2.6-223;  kinematics_viewpoint  offset  Information. 
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2.6.18.1.2  kinematics_calc_origin_state 


This  routine  calculates  the  state  variables  of  the  origin.  The  model  origin  is  not  necessarily 
coincident  with  the  center  of  gravity.  First  the  angular  velocity  w  is  transformed  into  frame 
A.  The  velocity  of  the  view  point  is  calculated  and  converted  to  frame  A.  Parameters  and 
variables  are  represented  as  follows: 


B_w 

B_v_cg 

BJC_A 

A_w 

A_v_o 

B  V  o 


—  Angular  velocity  in  frame  B 

—  Velocity  of  center  of  gravity  in  frame  B 

“  Direction  cosine  matrix  from  frame  B  to  frame  A 
--  Angular  velocity  in  frame  A 
--  Velocity  of  the  origin  in  frame  A 
--  Velocity  of  the  origin  in  frame  B 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

B_w 

VECTOR 

/simnet/common/include/glob 
al/sim  types. h 

B_v_cg 

VECTOR 

/simnetycommon/include/glob 
al/sim  types. h 

B_C_A 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

A_w 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

A_v_o 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

B_v_o 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

vec_.mat  mul 

Section  2.6.2.56.1 

kinematics  calc  velocity 

Section  2.6.18.2.1 

Table  2.6-224:  kinematics_calc_origin_state  Information. 
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2.6.18.2  calc  v.c 


Includes: 

"sim_types.h" 
"sim_dfns.h" 
"sim  macros.h 


ti 


2.6.18.2.1  kineinatics_calc_velocity 

This  routine  calculates  the  velocity  at  point  b  on  Body  B  given  the  velocity  at  point  a  and 
the  angular  velocity  of  Body  B  using  v_b  =  v_a  +  w\r.  Parameters  and  internal  variables 
are  represented  as  follows; 

r  —  Position  vector  to  the  point 

v_a  -  Velocity  at  point  a 

w  -  Angular  velocity  of  body  B 

v_b  —  Velocity  at  point  b 

w_x_r  —  Angular  velocity  (Omega)  cross  the  position  vector 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

r 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

v_a 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

w 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

v_b 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

w_x_r 

VECTOR 

/simnet/common/include/glob 
al/sim  types.h 

1  Calls  1 

Function 

Where  Described 

vec  cross  prod 

Section  2.6.2.66.1 

vec  add 

Section  2.6.2.57.1 

Table  2.6-225:  kinematics_calc_velocity  Information. 
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2.6.18.3  form_c.x 

“sim_types.h”  and  “sim_dfns.h”  are  included. 

2.6.18.3.1  kinematics_form_C 

This  routine  forms  the  Direction  Cosine  matrices  from  frame  A  to  frame  B  and  from  frame 
B  to  frame  A. 

A_e_B  —  Quaternion  for  rotation  of  Body  B  in  frame  A 
A_c_B  —  Direction  Cosine  matrix  from  frame  A  to  frame  B 

B  c  A  -  Direction  Cosine  matrix  from  frame  B  to  frame  A 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

A_e_B 

pointer  to  REAL 

/simnet/common/include/giob 
al/sim  types.h 

A_c_B 

T_MATRIX 

/simnet/common/include/glob 
al/sim  types. h 

B_C_A 

T_MATRIX 

/simnet/common/inciude/giob 
ai/sim  types.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

temp 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

eOeO 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

e0e1 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

e0e2 

REAL 

/simnet/common/inciude/glob 
ai/sim  types.h 

e0e3 

REAL 

/simnet/common/include/glob 
al/sim  types.h 

elei 

REAL 

/simnet/common/inciude/glob 
al/sim  types.h 

eie2 

REAL 

/simnet/common/include/giob 
al/sim  types.h 

e1e3 

REAL 

/simnet/common/include/giob 
al/sim  types.h 

e2e2  ■ 

REAL 

/simnet/common/include/giob 
al/sim  types.h 

e2e3 

REAL 

/simnet/corninon/include/giob 
ai/sim  types.h 

e3e3 

REAL 

/simnet/common/include/giob 
al/sim  types.h 

I  Calls 

Function 

Where  Described 

mat  transpose 

Section  2.6.2.51.1 

Table  2.6-226:  kinematics  form  C  Information. 
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2.6.18.4 


form  N.c 


Includes; 

"sim_types.h" 

"sim_dfns.h" 


2.6.18.4.1  kinematics_from_N 

This  routine  forms  the  unit  normal. 


B_C_A  -  Direction  cosine  matrix  from  B  to  A 
A  b2  —  Normal  vector  in  frame  A 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

B_C_A 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

A_b2 

VECTOR 

/simnet/common/inciude/glob 
al/sim  types,  h 

Table  2.6-227:  kinematics_form_N  Information. 


2.6.18.5  form  e.c 


Includes; 

"sim_types.h" 
"sim  dfns.h" 


2.6.18.5.1  kinematics_form_e 

This  routine  forms  the  Euler  parameters  from  w,  the  angular  velocity.  Note  that  all  Euler 
parameters  will  be  written  in  frame  A. 

A_w  —  The  angular  speed  vector 
e  -  The  euler  vector  and  parameter 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

A_w 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

e 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  tvpes.h 

Table  2.6-228:  kinematics_form_e  Information. 
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2.6.18.6  form_g.c 


Includes: 

"sim_types.h 

"sim_dfns.h" 


ti 


2.6.18.6.1  kinematics_form_G 

This  routine  forms  the  gravity  vector  in  frame  B. 

A_c_B  —  Direction  cosine  matrix  from  frame  A  to  fiame  B 
—  Gravity  vector  in  frame  B 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

A_C_B 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvoes.h 

B_g 

VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

Table  2.6-229:  kinematics_form_G  Information. 


2.6.18.7  form  r.c 


Includes; 

"sim_types.h 

sim_(frns.h" 


ft 


2.6.18.7.1  kinematics_form_r 

This  routine  forms  the  position  vector  from  BO*  to  B*. 

A_v  "  The  velocity  vector  in  frame  A. 

A_r  —  A  change  in  position  vector,  written  in  frame  A. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

A_v 

VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

A_r 

VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

Table  2.6-230:  kinematics  form  r  Information. 
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2.6.18.8  form  s.c 


Includes; 

"sim_types.h 

"sim_dfns.h" 

"libmatrix.h" 


ti 


2.6.18.8.1  kinematics_form_s 

This  routine  forms  the  position  vector  ftom  B*  to  origin,  where 

Bj)=Aj)  A_c_B  and  B_s  =  -B _p.  Parameters  and  variables  are  represented  as 

follows: 

Ajc_B  --  Direction  cosine  matrix  from  frame  A  to  frame  B 
A_p  --  Position  vector,  from  origin  to  B*  in  frame  A 
B  s  >-  Position  vector,  from  B*  to  the  origin  in  frame  B 
B_p  —  Position  vector  in  frame  B 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

A_c_B 

T_MATRIX 

/simnet/common/include/glob 
al/sim  tvpes.h 

A_P 

VECTOR 

/simnet/common/include/glob 
al/sim  types,  h 

B_s 

VECTOR 

/simnet/common/include/glob 
al/sim  Jvpes.h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

B_p 

VECTOR 

/simnet/common/include/glob 
al/sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

vec  mat  mul 

Section  2.6.2.56.1 

vec  nea 

Section  2.6.2.62.1 

Table  2.6>231:  kinematics  form  s  Information. 
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2.6.18.9  make  e.c 


Includes: 

"sim_types.h" 

"sim_dfns.h" 

"math.h" 

"libmatrix.h" 

Defines: 

REAL_SMALL 

Declarations: 

C 

e 

denominator 

line_no 


2.6.18.9.1  make_e 

This  routine  makes  the  Euler  parameters  from  the  Direction  cosine  matrix.  Parameters  are 
represented  as  follows: 

CJn  -  Direction  cosine  matrix 

ejn  -  Euler  parameters 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

CJn 

T_MATRIX 

/simnet/common/include/glob 
al/sim  types.h 

eJn 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types.h 

1  Calls  1 

Function 

Where  Described 

mat  copy 

Section  2.6.2.39.1 

elr  copy 

Section  2.6.2.3.1 

Table  2.6-232:  make  e  Information. 


2.6.18.9.2  quat_dump 


This  routine  prints  information  about  the  quaternion  equations  for  debugging  piuposes. 
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2.6.18.10  norm^e.c 

Includes; 

"math.h" 

"sim_types.h" 

"sim_dfns.h’' 

2.6.18.10.1  normalize_e 

This  routine  normalizes  the  euler  parameters,  where  e[4]  represents  the  euler  parameters. 

_ _ Parameters 

Parameter _ Type _ Where  Typedef  Declared 

e[4|  REAL  /simnet/common/include/glob 

al/sim  types.h 


_  Internal  Variables  _ 

Variable _ Type _ Where  Typedef  Declared 

mag  REAL  /simnet/common/include/glob 

al/sim  types.h 

Table  2.6-233:  normalize_e  Information. 

2.6.18.11  update_e.c 

Includes: 

"sim_types.h" 

"sim.dfns.h" 


2.6.18.11.1  kinematics_update_e 

This  routine  updates  the  Euler  parameters.  Parameters  are  represented  as  follows: 

B0_e_B  -  Euler  parameters  for  rotation  from  BO  to  B. 

A_e_B0  —  Euler  parameters  for  rotation  from  A  to  BO. 

A_e_B  -  Euler  parameters  for  rotation  from  A  to  B. 

_ _ Parameters _ _ 

Parameter _ Type _ Where  Typedef  Declared 

B0_e_B  pointer  to  REAL  /simnet/common/include/glob 

_ al/sim  types.h _ 

A_e_B0  pointer  to  REAL  /simnet/common/include/glob 

_ al/sim  types.h _ 

A_e_B  pointer  to  REAL  /simnet/common/include/glob 

al/sim  types.h  


_ Calls _ 

Function _ Where  Described _ 

normalize  e  Section  2.6.18.10.1 

Table  2.6-234:  kinematics_update_e  Information. 
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2.6.18^f  2  update_p.c 


Includes; 

"sani_types.h" 

"Miin_dfns.h" 

"Iilbmatrix.h" 


2 . 6 . 1 8 .  L2 . 1  kineniatics_update_p 

This  roudme  updates  the  position  vector  from  origin  to  B*,  where: 

A —j^_plk-lJ+A_rlk'l].  Parameters  are  represented  as  follows: 

A_v  —  The  velocity  vector  in  frame  A. 

A_r  —  Change  in  position,  written  in  frame  A. 

Ajp  -  Position  vector,  from  origin  to  B*  in  frame  A. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

A_v 

VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

A_r 

VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

A_P 

VECTOR 

/simnet/common/include/glob 
al/sim  tvoes.h 

1  Calls  1 

Function 

Where  Described 

vec  add 

Section  2.6.2.57.1 

Table  2.6-235:  kinematics_update_p  Information. 


